Source Control - Update

Referência

Serviço:: Automation

Versão da API:: 2023-11-01

Atualizar um controle do código-fonte.

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

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	Nome de um grupo de recursos do Azure. Padrão Regex: `^[-\w\._]+$`
sourceControlName	path	True	string	O nome do controle do código-fonte.
subscriptionId	path	True	string	Obtém as 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 do repositório do controle do código-fonte.
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	OK
Other Status Codes	ErrorResponse	Resposta de erro de automação que descreve por que a operação falhou.

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/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourceControls/sampleSourceControl?api-version=2023-11-01

{
  "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
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.
tokenType	O tipo do token. Deve ser PersonalAccessToken ou Oauth.

ErrorResponse

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

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

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso
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 do repositório do controle do código-fonte. Inclua o branch como uma cadeia de caracteres vazia para VsoTfvc.
properties.creationTime	string	A hora da criação.
properties.description	string	A descrição.
properties.folderPath	string	O caminho da pasta do controle do código-fonte.
properties.lastModifiedTime	string	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.
type	string	Tipo do recurso.

SourceControlSecurityTokenProperties

Nome	Tipo	Description
accessToken	string	O token de acesso.
refreshToken	string	O token de atualização.
tokenType	tokenType	O tipo do token. Deve ser PersonalAccessToken ou Oauth.

SourceControlUpdateParameters

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 do repositório do controle do código-fonte.
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

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

Nome	Tipo	Description
GitHub	string
VsoGit	string
VsoTfvc	string

tokenType

O tipo do token. Deve ser PersonalAccessToken ou Oauth.

Nome	Tipo	Description
Oauth	string
PersonalAccessToken	string

Compartilhar via