Source Control - Update

Serviço:
Automation
Versão da API:
2024-10-23

Atualize um controle de origem.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/sourceControls/{sourceControlName}?api-version=2024-10-23

Parâmetros do URI

Name Em Necessário Tipo Description
automationAccountName
 path True

string

O nome da conta de automação.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
sourceControlName
 path True

string

O nome do controle do código-fonte.
subscriptionId
 path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Tipo Description
properties.autoSync

boolean

A sincronização automática do controle do código-fonte. O valor padrão é falso.
properties.branch

string

A ramificação de recompra do controle de origem.
properties.description

string

A descrição do usuário do controle do código-fonte.
properties.folderPath

string

O caminho da pasta do controle do código-fonte. O caminho deve ser relativo.
properties.publishRunbook

boolean

A publicação automática do controle de origem. A predefinição é verdadeira.
properties.securityToken

SourceControlSecurityTokenProperties

O token de autorização para o repositório do controle de origem.

Respostas

Name Tipo Description
200 OK

SourceControl

Operação do Azure concluída com sucesso.
Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Update a source control

Pedido de amostra

PATCH https://management.azure.com/subscriptions/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourceControls/sampleSourceControl?api-version=2024-10-23

{
  "properties": {
    "description": "my description",
    "autoSync": true,
    "branch": "master",
    "folderPath": "/folderOne/folderTwo",
    "publishRunbook": true,
    "securityToken": {
      "accessToken": "******",
      "tokenType": "PersonalAccessToken"
    }
  }
}

Resposta da amostra

Código de estado:
200 
{
  "name": "sampleSourceControl",
  "id": "/subscriptions/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourcecontrols/sampleSourceControl",
  "properties": {
    "description": "my description",
    "autoSync": true,
    "branch": "master",
    "creationTime": "2017-03-28T22:59:00.937+00:00",
    "folderPath": "/folderOne/folderTwo",
    "lastModifiedTime": "2017-03-28T22:59:00.937+00:00",
    "publishRunbook": true,
    "repoUrl": "https://sampleUser.visualstudio.com/myProject/_git/myRepository",
    "sourceType": "VsoGit"
  }
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
SourceControl

Definição do controle do código-fonte.
SourceControlSecurityTokenProperties
SourceControlUpdateParameters

Os parâmetros fornecidos para a operação de controle do código-fonte de atualização.
SourceType

O tipo de fonte. Deve ser um dos VsoGit, VsoTfvc, GitHub.
systemData

Metadados referentes à criação e última modificação do recurso.
TokenType

O tipo de token. Deve ser PersonalAccessToken ou Oauth.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

SourceControl

Object

Definição do controle do código-fonte.

Name Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

O nome do recurso
properties.autoSync

boolean

A sincronização automática do controle do código-fonte. O valor padrão é falso.
properties.branch

string

A ramificação de recompra do controle de origem. Inclua branch como string vazia para VsoTfvc.
properties.creationTime

string (date-time)

O tempo de criação.
properties.description

string

A descrição.
properties.folderPath

string

O caminho da pasta do controle do código-fonte.
properties.lastModifiedTime

string (date-time)

A última hora modificada.
properties.publishRunbook

boolean

A publicação automática do controle de origem. A predefinição é verdadeira.
properties.repoUrl

string

A url de repositório do controle de origem.
properties.sourceType

SourceType

O tipo de fonte. Deve ser um dos VsoGit, VsoTfvc, GitHub.
systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SourceControlSecurityTokenProperties

Object
Name Tipo Description
accessToken

string

maxLength: 1024

O token de acesso.
refreshToken

string

maxLength: 1024

O token de atualização.
tokenType

TokenType

O tipo de token. Deve ser PersonalAccessToken ou Oauth.

SourceControlUpdateParameters

Object

Os parâmetros fornecidos para a operação de controle do código-fonte de atualização.

Name Tipo Description
properties.autoSync

boolean

A sincronização automática do controle do código-fonte. O valor padrão é falso.
properties.branch

string

A ramificação de recompra do controle de origem.
properties.description

string

A descrição do usuário do controle do código-fonte.
properties.folderPath

string

O caminho da pasta do controle do código-fonte. O caminho deve ser relativo.
properties.publishRunbook

boolean

A publicação automática do controle de origem. A predefinição é verdadeira.
properties.securityToken

SourceControlSecurityTokenProperties

O token de autorização para o repositório do controle de origem.

SourceType

Enumeração

O tipo de fonte. Deve ser um dos VsoGit, VsoTfvc, GitHub.

Valor Description
VsoGit

VsoGit
VsoTfvc

VsoTfvc
GitHub

GitHub

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

TokenType

Enumeração

O tipo de token. Deve ser PersonalAccessToken ou Oauth.

Valor Description
PersonalAccessToken

PersonalAccessToken
Oauth

Oauth