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 pattern: ^[-\w\._]+$	Nome de um grupo de recursos do Azure.
sourceControlName	path	True	string	O nome do controle do código-fonte.
subscriptionId	path	True	string	Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

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	OKEY
Other Status Codes	ErrorResponse	Resposta de erro de automação descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo 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/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourceControls/sampleSourceControl?api-version=2024-10-23

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

Resposta de exemplo

Código de status:: 200

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

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorResponse	Resposta de erro de uma falha de operação
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

ErrorResponse

Objeto

Resposta de erro de uma falha de operação

Nome	Tipo	Description
code	string	Código do erro
message	string	Mensagem de erro indicando por que a operação falhou.

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
VsoTfvc
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
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

ErrorResponse

SourceControl

SourceControlSecurityTokenProperties

SourceControlUpdateParameters

sourceType

systemData

tokenType