你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Webhooks - List Events

参考

服务:: Container Registry

API 版本:: 2023-01-01-preview

列出指定 Webhook 的最新事件。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{registryName}/webhooks/{webhookName}/listEvents?api-version=2023-01-01-preview

URI 参数

名称	在	必需	类型	说明
registryName	path	True	string minLength: 5 maxLength: 50 pattern: ^[a-zA-Z0-9]*$	容器注册表的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
webhookName	path	True	string minLength: 5 maxLength: 50 pattern: ^[a-zA-Z0-9]*$	Webhook 的名称。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	EventListResult	请求成功;请求格式正确，已正确接收。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

WebhookListEvents

示例请求

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerRegistry/registries/myRegistry/webhooks/myWebhook/listEvents?api-version=2023-01-01-preview

package armcontainerregistry_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerregistry/armcontainerregistry"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/969fd0c2634fbcc1975d7abe3749330a5145a97c/specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/WebhookListEvents.json
func ExampleWebhooksClient_NewListEventsPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerregistry.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewWebhooksClient().NewListEventsPager("myResourceGroup", "myRegistry", "myWebhook", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.EventListResult = armcontainerregistry.EventListResult{
		// 	Value: []*armcontainerregistry.Event{
		// 		{
		// 			ID: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 			EventRequestMessage: &armcontainerregistry.EventRequestMessage{
		// 				Method: to.Ptr("POST"),
		// 				Content: &armcontainerregistry.EventContent{
		// 					Action: to.Ptr("push"),
		// 					Actor: &armcontainerregistry.Actor{
		// 					},
		// 					ID: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 					Source: &armcontainerregistry.Source{
		// 						Addr: to.Ptr("xtal.local:5000"),
		// 						InstanceID: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 					},
		// 					Target: &armcontainerregistry.Target{
		// 						Digest: to.Ptr("sha256:fea8895f450959fa676bcc1df0611ea93823a735a01205fd8622846041d0c7cf"),
		// 						Length: to.Ptr[int64](708),
		// 						MediaType: to.Ptr("application/vnd.docker.distribution.manifest.v2+json"),
		// 						Repository: to.Ptr("hello-world"),
		// 						Size: to.Ptr[int64](708),
		// 						Tag: to.Ptr("latest"),
		// 						URL: to.Ptr("http://192.168.100.227:5000/v2/hello-world/manifests/sha256:fea8895f450959fa676bcc1df0611ea93823a735a01205fd8622846041d0c7cf"),
		// 					},
		// 					Timestamp: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-03-01T23:14:37.0707808Z"); return t}()),
		// 					Request: &armcontainerregistry.Request{
		// 						Method: to.Ptr("GET"),
		// 						Addr: to.Ptr("192.168.64.11:42961"),
		// 						Host: to.Ptr("192.168.100.227:5000"),
		// 						ID: to.Ptr("00000000-0000-0000-0000-000000000000"),
		// 						Useragent: to.Ptr("curl/7.38.0"),
		// 					},
		// 				},
		// 				Headers: map[string]*string{
		// 					"Authorization": to.Ptr("******"),
		// 					"Content-Length": to.Ptr("719"),
		// 					"Content-Type": to.Ptr("application/json"),
		// 				},
		// 				RequestURI: to.Ptr("http://myservice.com"),
		// 				Version: to.Ptr("1.1"),
		// 			},
		// 			EventResponseMessage: &armcontainerregistry.EventResponseMessage{
		// 				Headers: map[string]*string{
		// 					"Content-Length": to.Ptr("0"),
		// 				},
		// 				StatusCode: to.Ptr("200"),
		// 				Version: to.Ptr("1.1"),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerRegistryManagementClient } = require("@azure/arm-containerregistry");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists recent events for the specified webhook.
 *
 * @summary Lists recent events for the specified webhook.
 * x-ms-original-file: specification/containerregistry/resource-manager/Microsoft.ContainerRegistry/preview/2023-01-01-preview/examples/WebhookListEvents.json
 */
async function webhookListEvents() {
  const subscriptionId =
    process.env["CONTAINERREGISTRY_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERREGISTRY_RESOURCE_GROUP"] || "myResourceGroup";
  const registryName = "myRegistry";
  const webhookName = "myWebhook";
  const credential = new DefaultAzureCredential();
  const client = new ContainerRegistryManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.webhooks.listEvents(resourceGroupName, registryName, webhookName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "eventRequestMessage": {
        "content": {
          "id": "00000000-0000-0000-0000-000000000000",
          "timestamp": "2017-03-01T23:14:37.0707808Z",
          "action": "push",
          "target": {
            "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
            "size": 708,
            "digest": "sha256:fea8895f450959fa676bcc1df0611ea93823a735a01205fd8622846041d0c7cf",
            "length": 708,
            "repository": "hello-world",
            "url": "http://192.168.100.227:5000/v2/hello-world/manifests/sha256:fea8895f450959fa676bcc1df0611ea93823a735a01205fd8622846041d0c7cf",
            "tag": "latest"
          },
          "request": {
            "id": "00000000-0000-0000-0000-000000000000",
            "addr": "192.168.64.11:42961",
            "host": "192.168.100.227:5000",
            "method": "GET",
            "useragent": "curl/7.38.0"
          },
          "actor": {},
          "source": {
            "addr": "xtal.local:5000",
            "instanceID": "00000000-0000-0000-0000-000000000000"
          }
        },
        "headers": {
          "Content-Type": "application/json",
          "Content-Length": "719",
          "Authorization": "******"
        },
        "method": "POST",
        "requestUri": "http://myservice.com",
        "version": "1.1"
      },
      "eventResponseMessage": {
        "headers": {
          "Content-Length": "0"
        },
        "statusCode": "200",
        "version": "1.1"
      }
    }
  ]
}

定义

名称	说明
Actor	启动事件的代理。在大多数情况下，这可能来自请求的授权上下文。
Event	Webhook 的事件。
EventContent	事件请求消息的内容。
EventListResult	列出 Webhook 事件的请求的结果。
EventRequestMessage	发送到服务 URI 的事件请求消息。
EventResponseMessage	从服务 URI 接收的事件响应消息。
Request	生成事件的请求。
Source	生成事件的注册表节点。以不同的方式，当执行组件启动事件时，源将生成该事件。
Target	事件的目标。

Actor

Object

启动事件的代理。在大多数情况下，这可能来自请求的授权上下文。

名称	类型	说明
name	string	与生成事件的请求上下文关联的主题或用户名。

Event

Object

Webhook 的事件。

名称	类型	说明
eventRequestMessage	EventRequestMessage	发送到服务 URI 的事件请求消息。
eventResponseMessage	EventResponseMessage	从服务 URI 接收的事件响应消息。
id	string	事件 ID。

EventContent

Object

事件请求消息的内容。

名称	类型	说明
action	string	包含提供事件的作。
actor	Actor	启动事件的代理。在大多数情况下，这可能来自请求的授权上下文。
id	string	事件 ID。
request	Request	生成事件的请求。
source	Source	生成事件的注册表节点。以不同的方式，当执行组件启动事件时，源将生成该事件。
target	Target	事件的目标。
timestamp	string (date-time)	事件发生的时间。

EventListResult

Object

列出 Webhook 事件的请求的结果。

名称	类型	说明
nextLink	string	可用于请求下一个事件列表的 URI。
value	Event[]	事件列表。由于此列表可能不完整，因此下一个Link 字段应用于请求下一个事件列表。

EventRequestMessage

Object

发送到服务 URI 的事件请求消息。

名称	类型	说明
content	EventContent	事件请求消息的内容。
headers	object	事件请求消息的标头。
method	string	用于发送事件请求消息的 HTTP 方法。
requestUri	string	用于发送事件请求消息的 URI。
version	string	HTTP 消息版本。

EventResponseMessage

Object

从服务 URI 接收的事件响应消息。

名称	类型	说明
content	string	事件响应消息的内容。
headers	object	事件响应消息的标头。
reasonPhrase	string	事件响应消息的原因短语。
statusCode	string	事件响应消息的状态代码。
version	string	HTTP 消息版本。

Request

Object

生成事件的请求。

名称	类型	说明
addr	string	发起事件的客户端连接的 IP 或主机名和可能端口。这是标准 http 请求中的 RemoteAddr。
host	string	注册表实例的外部可访问主机名，由传入请求上的 http 主机标头指定。
id	string	启动事件的请求 ID。
method	string	生成事件的请求方法。
useragent	string	请求的用户代理标头。

Source

Object

生成事件的注册表节点。以不同的方式，当执行组件启动事件时，源将生成该事件。

名称	类型	说明
addr	string	生成事件的注册表节点的 IP 或主机名和端口。通常，OS 会解决此问题。主机名（）以及正在运行的端口。
instanceID	string	应用程序的运行实例。每次重启后更改。

Target

Object

事件的目标。

名称	类型	说明
digest	string	内容摘要，由注册表 V2 HTTP API 规范定义。
length	integer (int64)	内容的字节数。与 Size 字段相同。
mediaType	string	引用对象的 MIME 类型。
name	string	项目的名称。
repository	string	存储库名称。
size	integer (int64)	内容的字节数。与 Length 字段相同。
tag	string	标记名称。
url	string	内容的直接 URL。
version	string	项目的版本。

通过

Webhooks - List Events

URI 参数

响应

安全性

azure_auth

作用域

示例

WebhookListEvents

示例请求

示例响应

定义

Actor

Event

EventContent

EventListResult

EventRequestMessage

EventResponseMessage

Request

Source

Target

其他资源