privileges リソース

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Bitbucket Cloud v1 APIs are deprecated

Bitbucket Cloud REST API version 1 is deprecated effective 30 June 2018. All 1.0 APIs will be removed from the REST API permanently on 31 December 2018. Read the deprecation notice. Or you can jump right to the version 2.0 REST API documentation.

概要

このリソースを使用して、チーム アカウントの権限設定を管理します。チーム アカウントはグループに対してアカウント権限とリポジトリ アクセスを付与できます。アカウント権限を付与されたグループは、アカウントを管理 (管理権限) またはアカウント内でリポジトリを作成 (コラボレーター権限) できます。

この呼び出しでの個人アカウントのサポートについて

この呼び出しを個人アカウントについて行うことはできますが、結果は空のデータセットになります。これは、個人アカウントについてアカウント権限を設定することができないためです。

グループにメンバーを追加する方法については、group-privileges エンドポイントprivileges エンドポイントをご参照ください。

チーム アカウントの権限グループの一覧の取得

チーム アカウントでアカウント権限が定義されているグループを取得します。管理権限にはコラボレーター権限が自動的に含まれます。いすれかのオプションが設定されているグループは結果から除外されます。呼び出し元は認証を行っている必要があります。アクセスのための認証情報は、オーナーまたは管理権限を持つアカウントのものである必要があります。これは、チーム アカウントのアクセス情報またはチーム アカウントを管理できるメンバーとなります。このメソッドでは次のパラメータを使用します。

パラメーター
必須かどうか
説明
accountname はい The team or individual account name.
group_slug はい The group's slug.
GET https://api.bitbucket.org/1.0/users/{accountname}/privileges
ここをクリックして展開...
{
    "2team/administrators": "admin",
    "2team/developers": "collaborator"
}

グループに関連付けられた権限の取得

指定した groupname に関連付けられた権限を取得します。権限は collaborator または admin です。呼び出し元は認証を行っている必要があります。アクセスのための認証情報は、オーナーまたは管理権限を持つアカウントのものである必要があります。これは、チーム アカウントのアクセス情報またはチーム アカウントを管理できるメンバーとなります。このメソッドでは次のパラメータを使用します。

パラメーター
必須かどうか
説明
accountname はい The team or individual account name.
owner はい The account that owns the group.
group_slug はい The group's slug.
GET https://api.bitbucket.org/1.0/users/{accountname}/privileges/{owner}/{group_slug}
ここをクリックして展開...
{
    "privilege": "collaborator"
}

チーム アカウントのグループ権限の更新

チーム アカウントの既存のグループの権限を更新します。グループの権限は admin または collaborator に設定します。この呼び出しは、変更後のグループを返します。呼び出し元は認証を行っている必要があります。アクセスのための認証情報は、オーナーまたは管理権限を持つアカウントのものである必要があります。これは、チーム アカウントのアクセス情報またはチーム アカウントを管理できるメンバーとなります。このメソッドでは次のパラメータを使用します。

パラメーター
必須かどうか
説明
accountname はい The team or individual account name.
owner はい The account that owns the group.
group_slug はい The group's slug.
privileges はい admin または collaborator
PUT https://api.bitbucket.org/1.0/users/{accountname}/privileges/{owner}/{group_slug}--data "privileges=admin"
ここをクリックして展開...
{
    "2team/contractors": "admin"
}

新しい権限の追加

グループに新しく権限を追加します。呼び出し元は認証を行っている必要があります。アクセスのための認証情報は、オーナーまたは管理権限を持つアカウントのものである必要があります。これは、チーム アカウントのアクセス情報またはチーム アカウントを管理できるメンバーとなります。このメソッドでは次のパラメータを使用します。

パラメーター
必須かどうか
説明
accountname はい The team or individual account name.
owner はい The account that owns the group.
group_slug はい The group's slug.
privileges はい admin または collaborator
 POST https://api.bitbucket.org/1.0/users/{accountname}/privileges/{owner}/{group_slug}--data "privileges=admin"
ここをクリックして展開...
{
    "2team/contractors": "admin"
}


権限グループの削除

権限を削除します。呼び出し元は認証を行っている必要があります。アクセスのための認証情報は、オーナーまたは管理権限を持つアカウントのものである必要があります。これは、チーム アカウントのアクセス情報またはチーム アカウントを管理できるメンバーとなります。このメソッドでは次のパラメータを使用します。

パラメーター
必須かどうか
説明
accountname はい The team or individual account name.
owner はい The account that owns the group.
group_slug はい The group's slug.
DELETE https://api.bitbucket.org/1.0/users/{accountname}/privileges/{owner}/{group_slug} 

成功した場合、呼び出しに対して  HTTP/1.1 204 NO CONTENT が返されます。

最終更新日 2018 年 6 月 14 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.