Source Control - Update

Referência

Serviço:: Automation

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

Atualizar um controlo de origem.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
automationAccountName	path	True	string	O nome da conta de automatização.
resourceGroupName	path	True	string	Nome de um grupo de Recursos do Azure. Padrão Regex: `^[-\w\._]+$`
sourceControlName	path	True	string	O nome do controlo de origem.
subscriptionId	path	True	string	Obtém credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API de Cliente.

Corpo do Pedido

Name	Tipo	Description
properties.autoSync	boolean	A sincronização automática do controlo de origem. A predefinição é falso.
properties.branch	string	O ramo de repositório do controlo de origem.
properties.description	string	A descrição do utilizador do controlo de origem.
properties.folderPath	string	O caminho da pasta do controlo de origem. O caminho tem de ser relativo.
properties.publishRunbook	boolean	A publicação automática do controlo de origem. A predefinição é verdadeiro.
properties.securityToken	SourceControlSecurityTokenProperties	O token de autorização para o repositório do controlo de origem.

Respostas

Name	Tipo	Description
200 OK	SourceControl	OK
Other Status Codes	ErrorResponse	Resposta de erro de automatização que descreve o motivo pela qual a operação falhou.

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	representar 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=2023-11-01

{
  "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
ErrorResponse	Resposta de erro de uma falha de operação
SourceControl	Definição do controlo de origem.
SourceControlSecurityTokenProperties
SourceControlUpdateParameters	Os parâmetros fornecidos para a operação de controlo de origem de atualização.
sourceType	O tipo de origem. Tem de ser de VsoGit, VsoTfvc, GitHub.
tokenType	O tipo de token. Tem de ser PersonalAccessToken ou Oauth.

ErrorResponse

Resposta de erro de uma falha de operação

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

SourceControl

Definição do controlo de origem.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso
name	string	O nome do recurso
properties.autoSync	boolean	A sincronização automática do controlo de origem. A predefinição é falso.
properties.branch	string	O ramo de repositório do controlo de origem. Inclua o ramo como cadeia vazia para VsoTfvc.
properties.creationTime	string	A hora de criação.
properties.description	string	A descrição.
properties.folderPath	string	O caminho da pasta do controlo de origem.
properties.lastModifiedTime	string	A última hora modificada.
properties.publishRunbook	boolean	A publicação automática do controlo de origem. A predefinição é verdadeiro.
properties.repoUrl	string	O URL do repositório do controlo de origem.
properties.sourceType	sourceType	O tipo de origem. Tem de ser de VsoGit, VsoTfvc, GitHub.
type	string	O tipo de recurso.

SourceControlSecurityTokenProperties

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

SourceControlUpdateParameters

Os parâmetros fornecidos para a operação de controlo de origem de atualização.

Name	Tipo	Description
properties.autoSync	boolean	A sincronização automática do controlo de origem. A predefinição é falso.
properties.branch	string	O ramo de repositório do controlo de origem.
properties.description	string	A descrição do utilizador do controlo de origem.
properties.folderPath	string	O caminho da pasta do controlo de origem. O caminho tem de ser relativo.
properties.publishRunbook	boolean	A publicação automática do controlo de origem. A predefinição é verdadeiro.
properties.securityToken	SourceControlSecurityTokenProperties	O token de autorização para o repositório do controlo de origem.

sourceType

O tipo de origem. Tem de ser de VsoGit, VsoTfvc, GitHub.

Name	Tipo	Description
GitHub	string
VsoGit	string
VsoTfvc	string

tokenType

O tipo de token. Tem de ser PersonalAccessToken ou Oauth.

Name	Tipo	Description
Oauth	string
PersonalAccessToken	string

Partilhar via