Source Control - Update

Referenz

Dienst:: Automation

API-Version:: 2023-11-01

Aktualisieren sie eine Quellcodeverwaltung.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
automationAccountName	path	True	string	Der Name des Automation-Kontos.
resourceGroupName	path	True	string	Name einer Azure-Ressourcengruppe. RegEx-Muster: `^[-\w\._]+$`
sourceControlName	path	True	string	Der Name der Quellcodeverwaltung.
subscriptionId	path	True	string	Ruft die Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
properties.autoSync	boolean	Die automatische Synchronisierung der Quellcodeverwaltung. Der Standardwert ist "false".
properties.branch	string	Der Repositorybranch der Quellcodeverwaltung.
properties.description	string	Die Benutzerbeschreibung der Quellcodeverwaltung.
properties.folderPath	string	Der Ordnerpfad der Quellcodeverwaltung. Der Pfad muss relativ sein.
properties.publishRunbook	boolean	Die automatische Veröffentlichung der Quellcodeverwaltung. Der Standardwert ist "true".
properties.securityToken	SourceControlSecurityTokenProperties	Das Autorisierungstoken für das Repository der Quellcodeverwaltung.

Antworten

Name	Typ	Beschreibung
200 OK	SourceControl	OK
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Update a source control

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
ErrorResponse	Fehlerantwort eines Vorgangsfehlers
SourceControl	Definition der Quellcodeverwaltung.
SourceControlSecurityTokenProperties
SourceControlUpdateParameters	Die Parameter, die für den Update-Quellcodeverwaltungsvorgang bereitgestellt werden.
sourceType	Der Quelltyp. Muss eine von VsoGit, VsoTfvc, GitHub sein.
tokenType	Der Tokentyp. Muss entweder PersonalAccessToken oder Oauth sein.

ErrorResponse

Fehlerantwort eines Vorgangsfehlers

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

SourceControl

Definition der Quellcodeverwaltung.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource
name	string	Der Name der Ressource
properties.autoSync	boolean	Die automatische Synchronisierung der Quellcodeverwaltung. Der Standardwert ist "false".
properties.branch	string	Der Repositorybranch der Quellcodeverwaltung. Schließen Sie Branch als leere Zeichenfolge für VsoTfvc ein.
properties.creationTime	string	Die Erstellungszeit.
properties.description	string	Die Beschreibung.
properties.folderPath	string	Der Ordnerpfad der Quellcodeverwaltung.
properties.lastModifiedTime	string	Der Zeitpunkt der letzten Änderung.
properties.publishRunbook	boolean	Die automatische Veröffentlichung der Quellcodeverwaltung. Der Standardwert ist "true".
properties.repoUrl	string	Die Repository-URL der Quellcodeverwaltung.
properties.sourceType	sourceType	Der Quelltyp. Muss eine von VsoGit, VsoTfvc, GitHub sein.
type	string	Der Typ der Ressource.

SourceControlSecurityTokenProperties

Name	Typ	Beschreibung
accessToken	string	Zugriffstoken
refreshToken	string	Das Aktualisierungstoken.
tokenType	tokenType	Der Tokentyp. Muss entweder PersonalAccessToken oder Oauth sein.

SourceControlUpdateParameters

Die Parameter, die für den Update-Quellcodeverwaltungsvorgang bereitgestellt werden.

Name	Typ	Beschreibung
properties.autoSync	boolean	Die automatische Synchronisierung der Quellcodeverwaltung. Der Standardwert ist "false".
properties.branch	string	Der Repositorybranch der Quellcodeverwaltung.
properties.description	string	Die Benutzerbeschreibung der Quellcodeverwaltung.
properties.folderPath	string	Der Ordnerpfad der Quellcodeverwaltung. Der Pfad muss relativ sein.
properties.publishRunbook	boolean	Die automatische Veröffentlichung der Quellcodeverwaltung. Der Standardwert ist "true".
properties.securityToken	SourceControlSecurityTokenProperties	Das Autorisierungstoken für das Repository der Quellcodeverwaltung.

sourceType

Der Quelltyp. Muss eine von VsoGit, VsoTfvc, GitHub sein.

Name	Typ	Beschreibung
GitHub	string
VsoGit	string
VsoTfvc	string

tokenType

Der Tokentyp. Muss entweder PersonalAccessToken oder Oauth sein.

Name	Typ	Beschreibung
Oauth	string
PersonalAccessToken	string

Freigeben über