Source Control - Update

Serviço:: Automation

Versão da API:: 2024-10-23

Atualize um controle do código-fonte.

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

Parâmetros de URI

Nome	Em	Obrigató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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties.autoSync	boolean	A sincronização automática do controle do código-fonte. O padrão é false.
properties.branch	string	O branch de repositório 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 do código-fonte. O padrão é true.
properties.securityToken	SourceControlSecurityTokenProperties	O token de autorização para o repositório do controle do código-fonte.

Respostas

Nome	Tipo	Description
200 OK	SourceControl	A operação do Azure foi concluída com êxito.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Update a source control

Solicitação de exemplo

HTTP

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 de exemplo

Código de status:: 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

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
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 origem. Deve ser um vsoGit, VsoTfvc, GitHub.
systemData	Metadados relativos à 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

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

SourceControl

Objeto

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

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada 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 padrão é false.
properties.branch	string	O branch de repositório do controle de origem. Incluir branch como cadeia de caracteres vazia para VsoTfvc.
properties.creationTime	string (date-time)	A hora 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 hora da última modificação.
properties.publishRunbook	boolean	A publicação automática do controle do código-fonte. O padrão é true.
properties.repoUrl	string	A URL do repositório do controle do código-fonte.
properties.sourceType	SourceType	O tipo de origem. Deve ser um vsoGit, VsoTfvc, GitHub.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SourceControlSecurityTokenProperties

Objeto

Nome	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

Objeto

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

Nome	Tipo	Description
properties.autoSync	boolean	A sincronização automática do controle do código-fonte. O padrão é false.
properties.branch	string	O branch de repositório 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 do código-fonte. O padrão é true.
properties.securityToken	SourceControlSecurityTokenProperties	O token de autorização para o repositório do controle do código-fonte.

SourceType

Enumeração

O tipo de origem. Deve ser um vsoGit, VsoTfvc, GitHub.

Valor	Description
VsoGit	VsoGit
VsoTfvc	VsoTfvc
GitHub	GitHub

systemData

Objeto

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

Nome	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

Compartilhar via

Source Control - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Update a source control

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SourceControl

SourceControlSecurityTokenProperties

SourceControlUpdateParameters

SourceType

systemData

TokenType