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 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. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

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

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

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 da amostra

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

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

ErrorResponse

Object

Resposta de erro de uma falha de operação

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

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

Partilhar via

Source Control - Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Update a source control

Pedido de amostra

Resposta da amostra

Definições

createdByType

ErrorResponse

SourceControl

SourceControlSecurityTokenProperties

SourceControlUpdateParameters

sourceType

systemData

tokenType