조직 멤버 목록 조회
조직 멤버 목록 조회
조직의 멤버 목록을 반환해요. last_logged_in_at, last_seen_at, last_desktop_version 필드는 insights가 활성화된 조직에서만 볼 수 있어요.
출처: 문서
본문
GET /v2/orgs/{org_name}/members
조직 멤버 목록 조회 작업이에요. 조직의 멤버 목록을 반환해요. last_logged_in_at, last_seen_at, last_desktop_version 필드는 insights가 활성화된 조직에서만 볼 수 있어요.
요청 예시
실행 전에 자리 표시자를 바꾸고 필요 자격 증명이나 요청 바디를 채워야 해요.
curl \
--request GET \
--header "Authorization: Bearer ${TOKEN}" \
--header 'Accept: application/json' \
'https://hub.docker.com/v2/orgs/myorganization/members?type=all&role=owner'
요청과 응답
응답 200 List of members
Schema:
{
"$ref": "#/components/schemas/org_member_paginated"
}
Schema example:
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"date_joined": "2021-01-05T21:06:53.506400Z",
"email": "[email protected]",
"full_name": "Jon Snow",
"groups": [
"owners"
],
"id": "0ab70deb065a43fcacd55d48caa945d8",
"is_guest": false,
"role": "Owner",
"type": "User",
"username": "dockeruser"
}
]
}
응답 400 Bad Request
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "bad request"
}
응답 401 Unauthorized
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "unauthorized"
}
응답 403 Forbidden
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "permission denied"
}
응답 404 Not Found
Schema:
{
"$ref": "#/components/schemas/error"
}
error:
{
"errinfo": null,
"message": "not found"
}
전체 작업 계약
{
"description": "Returns a list of members for an organization.\n\n_The following fields are only visible to orgs with insights enabled._\n\n- `last_logged_in_at`\n- `last_seen_at`\n- `last_desktop_version`\n\nTo make visible, please see [View Insights for organization users](https://docs.docker.com/accounts/organization/insights/#view-insights-for-organization-users).\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n",
"operationId": "getV2OrgsByOrgNameMembers",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/org_member_paginated"
}
}
},
"description": "List of members"
},
"400": {
"$ref": "#/components/responses/bad_request"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/not_found"
}
},
"security": [
{
"bearerAuth": []
}
],
"summary": "List org members",
"tags": [
"orgs"
]
}