Webhooks - Create
Crea un webhook per un registro contenitori con i parametri specificati.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/webhooks/{webhookName}?api-version=2023-01-01-preview
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
registry
|
path | True |
string |
Nome del registro contenitori. Regex pattern: |
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
subscription
|
path | True |
string uuid |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
webhook
|
path | True |
string |
Nome del webhook. Regex pattern: |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
location | True |
string |
Percorso del webhook. Questa operazione non può essere modificata dopo la creazione della risorsa. |
properties.actions | True |
Elenco di azioni che attivano il webhook per pubblicare le notifiche. |
|
properties.serviceUri | True |
string |
URI del servizio per il webhook per la pubblicazione delle notifiche. |
properties.customHeaders |
object |
Intestazioni personalizzate che verranno aggiunte alle notifiche del webhook. |
|
properties.scope |
string |
Ambito dei repository in cui è possibile attivare l'evento. Ad esempio, 'foo:*' significa eventi per tutti i tag nel repository 'foo'. 'foo:bar' significa eventi solo per 'foo:bar'. 'foo' equivale a 'foo:latest'. Vuoto indica tutti gli eventi. |
|
properties.status |
Stato del webhook al momento della chiamata dell'operazione. |
||
tags |
object |
Tag per il webhook. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
La richiesta ha avuto esito positivo; la richiesta è stata ben formata e ricevuta correttamente. |
|
201 Created |
La richiesta ha avuto esito positivo; l'operazione verrà completata in modo asincrono. Headers Azure-AsyncOperation: string |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
WebhookCreate
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/webhooks/myWebhook?api-version=2023-01-01-preview
{
"location": "westus",
"tags": {
"key": "value"
},
"properties": {
"serviceUri": "http://myservice.com",
"customHeaders": {
"Authorization": "******"
},
"status": "enabled",
"scope": "myRepository",
"actions": [
"push"
]
}
}
Sample Response
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/webhooks/myWebhook",
"name": "myWebhook",
"type": "Microsoft.ContainerRegistry/registries/webhooks",
"location": "westus",
"tags": {
"key": "value"
},
"properties": {
"status": "enabled",
"scope": "myRepository",
"actions": [
"push"
],
"provisioningState": "Succeeded"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/webhooks/myWebhook/operationStatuses/webhooks-00000000-0000-0000-0000-000000000000?api-version=2023-01-01-preview
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/webhooks/myWebhook",
"name": "myWebhook",
"type": "Microsoft.ContainerRegistry/registries/webhooks",
"location": "westus",
"tags": {
"key": "value"
},
"properties": {
"status": "enabled",
"scope": "myRepository",
"actions": [
"push"
],
"provisioningState": "Creating"
}
}
Definizioni
Nome | Descrizione |
---|---|
created |
Tipo di identità che ha creato la risorsa. |
last |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
Provisioning |
Stato di provisioning della risorsa. |
System |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Webhook |
Oggetto che rappresenta un webhook per un registro contenitori. |
Webhook |
Elenco di azioni che attivano il webhook per pubblicare le notifiche. |
Webhook |
Parametri per la creazione di un webhook. |
Webhook |
Stato del webhook al momento della chiamata dell'operazione. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
lastModifiedByType
Tipo di identità che ha modificato l'ultima volta la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ProvisioningState
Stato di provisioning della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
SystemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp della modifica della risorsa (UTC). |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
Webhook
Oggetto che rappresenta un webhook per un registro contenitori.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
L'ID della risorsa. |
location |
string |
Il percorso della risorsa. Questa operazione non può essere modificata dopo la creazione della risorsa. |
name |
string |
Nome della risorsa. |
properties.actions |
Elenco di azioni che attivano il webhook per pubblicare le notifiche. |
|
properties.provisioningState |
Stato di provisioning del webhook al momento della chiamata dell'operazione. |
|
properties.scope |
string |
Ambito dei repository in cui è possibile attivare l'evento. Ad esempio, 'foo:*' significa eventi per tutti i tag nel repository 'foo'. 'foo:bar' significa eventi solo per 'foo:bar'. 'foo' equivale a 'foo:latest'. Vuoto indica tutti gli eventi. |
properties.status |
Stato del webhook al momento della chiamata dell'operazione. |
|
systemData |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
|
tags |
object |
Tag della risorsa. |
type |
string |
Tipo di risorsa. |
WebhookAction
Elenco di azioni che attivano il webhook per pubblicare le notifiche.
Nome | Tipo | Descrizione |
---|---|---|
chart_delete |
string |
|
chart_push |
string |
|
delete |
string |
|
push |
string |
|
quarantine |
string |
WebhookCreateParameters
Parametri per la creazione di un webhook.
Nome | Tipo | Descrizione |
---|---|---|
location |
string |
Percorso del webhook. Questa operazione non può essere modificata dopo la creazione della risorsa. |
properties.actions |
Elenco di azioni che attivano il webhook per pubblicare le notifiche. |
|
properties.customHeaders |
object |
Intestazioni personalizzate che verranno aggiunte alle notifiche del webhook. |
properties.scope |
string |
Ambito dei repository in cui è possibile attivare l'evento. Ad esempio, 'foo:*' significa eventi per tutti i tag nel repository 'foo'. 'foo:bar' significa eventi solo per 'foo:bar'. 'foo' equivale a 'foo:latest'. Vuoto indica tutti gli eventi. |
properties.serviceUri |
string |
URI del servizio per il webhook per la pubblicazione delle notifiche. |
properties.status |
Stato del webhook al momento della chiamata dell'operazione. |
|
tags |
object |
Tag per il webhook. |
WebhookStatus
Stato del webhook al momento della chiamata dell'operazione.
Nome | Tipo | Descrizione |
---|---|---|
disabled |
string |
|
enabled |
string |