Cloud Storage API V2(Java)を使用して、
Cloud StorageのHMACキー情報を取得する方法
についてご紹介します。

HMACキーとは
アカウントに関連付けられた認証情報の一種です。
HMACキーを使用して署名を作成すると、その署名がCloudStorageに対するリクエストに組み込まれます。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Cloud Storage API(V2)] JavaでCloud Storageを使う
を参照ください。

No		目次
1		HMACキーリストを取得
	1	スコープ
	2	実行
	3	レスポンスの内容
2		HMACキーを取得
	1	スコープ
	2	実行
	3	レスポンスの内容

1. HMACキーリストを取得

指定したプロジェクトのHMACキーリストを取得します。

1.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

StorageScopes.CLOUD_PLATFORM
StorageScopes.DEVSTORAGE_FULL_CONTROL

⧉[Cloud Storage API(V2)] JavaでCloud Storageを使う(2.2 Storageインスタンスを取得)
でスコープを指定してください。

1.2. 実行

public static void main(String[] args) throws Exception{
    Storage storage = getStorage();
    Storage.Projects projects = storage.projects();
    Storage.Projects.HmacKeys hmacKeys = projects.hmacKeys();
    Storage.Projects.HmacKeys.List list = hmacKeys.list("プロジェクトID");
    
    HmacKeysMetadata res = list.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

GET:　https://storage.googleapis.com/storage/v1/projects/{プロジェクトID}/hmacKeys
が実行されます。

1.2.2. クエリパラメータ

Storage.Projects.HmacKeys.Listのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setMaxResults	Long	取得する最大数
setPageToken	String	取得するページトークン
setServiceAccountEmail	String	取得するHMACキーのサービスアカウントのメールアドレス
setShowDeletedKeys	Boolean	DELETED状態のキーを含めるか

1.3. レスポンスの内容

HmacKeysMetadata

メソッド	戻り値	説明
getKind	String	リソースの種類固定文字列："storage#hmacKeysMetadata"
getNextPageToken	String	次のページトークン
getItems	List<HmacKeyMetadata>	HMACキーのリスト

HmacKeyMetadata

メソッド	戻り値	説明
getId	String	HMACキーID
getKind	String	リソースの種類固定文字列："storage#hmacKeyMetadata"
getAccessId	String	HMACキーのアクセスID
getEtag	String	HMACキーのHTTPエンティティタグ
getSelfLink	String	リソースへのリンク
getProjectId	String	キーが認証するサービスアカウントを所有するプロジェクトID
getServiceAccountEmail	String	キーに関連付けられたサービスアカウントのメールアドレス
getState	String	キーの状態 "ACTIVE"、"INACTIVE"、"DELETED"
getTimeCreated	DateTime	HMACキーの作成時刻
getUpdated	DateTime	HMACキーメタデータの更新時刻

2. HMACキーを取得

指定したHMACキーのメタデータを取得します。

2.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

StorageScopes.CLOUD_PLATFORM
StorageScopes.DEVSTORAGE_FULL_CONTROL

⧉[Cloud Storage API(V2)] JavaでCloud Storageを使う(2.2 Storageインスタンスを取得)
でスコープを指定してください。

2.2. 実行

HMACキーのアクセスIDは、HmacKeyMetadataのgetAccessId()で取得できる値を使用します。

public static void main(String[] args) throws Exception{
    Storage storage = getStorage();
    Storage.Projects projects = storage.projects();
    Storage.Projects.HmacKeys hmacKeys = projects.hmacKeys();
    Storage.Projects.HmacKeys.Get get = hmacKeys.get("プロジェクトID","HMACキーのアクセスID");

    HmacKeyMetadata res = get.execute();
    System.out.println(res);
}

2.2.1. HTTPリクエスト

GET:　https://storage.googleapis.com/storage/v1/projects/{プロジェクトID}/hmacKeys/{HMACキーのアクセスID}
が実行されます。

2.2.2. クエリパラメータ

クエリパラメータはありません。

2.3. レスポンスの内容

HmacKeyMetadata

2.3. レスポンスの内容(HmacKeyMetadata)と同じです。

おしまい。。