さくらのクラウド さくらのクラウド API ポータル クラウドマニュアルへ
API docs by Redocly

KMS/SecretManager/CloudHSM API (1.2.0)

Download OpenAPI specification:Download OpenAPI Spec (YAML)Download OpenAPI Spec (JSON)

さくらのクラウド KMS / SecretManager / CloudHSM API

cloudhsm

listCloudHSMs

Authorizations:
basicAuth
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "CloudHSMs": [
    ],
  • "is_ok": true
}

createCloudHSM

Authorizations:
basicAuth
Request Body schema: application/json
required
required
object (CreateCloudHSMRequest)

Responses

Request samples

Content type
application/json
{
  • "CloudHSM": {
    }
}

Response samples

Content type
application/json
{
  • "CloudHSM": {
    },
  • "is_ok": true
}

listCloudHSMClients

Authorizations:
basicAuth
path Parameters
cloudhsm_resource_id
required
string
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "Clients": [
    ],
  • "is_ok": true
}

createCloudHSMClient

Authorizations:
basicAuth
path Parameters
cloudhsm_resource_id
required
string
Request Body schema: application/json
required
required
object (CreateCloudHSMClientRequest)

Responses

Request samples

Content type
application/json
{
  • "Client": {
    }
}

Response samples

Content type
application/json
{
  • "Client": {
    },
  • "is_ok": true
}

readCloudHSMClient

Authorizations:
basicAuth
path Parameters
cloudhsm_resource_id
required
string
id
required
string

A unique value identifying this CloudHSMクライアント.

Responses

Response samples

Content type
application/json
{
  • "Client": {
    },
  • "is_ok": true
}

updateCloudHSMClient

Authorizations:
basicAuth
path Parameters
cloudhsm_resource_id
required
string
id
required
string

A unique value identifying this CloudHSMクライアント.

Request Body schema: application/json
required
required
object (CloudHSMClientRequest)

Responses

Request samples

Content type
application/json
{
  • "Client": {
    }
}

Response samples

Content type
application/json
{
  • "Client": {
    },
  • "is_ok": true
}

deleteCloudHSMClient

Authorizations:
basicAuth
path Parameters
cloudhsm_resource_id
required
string
id
required
string

A unique value identifying this CloudHSMクライアント.

Responses

readCloudHSM

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "CloudHSM": {
    },
  • "is_ok": true
}

updateCloudHSM

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (CloudHSMRequest)

Responses

Request samples

Content type
application/json
{
  • "CloudHSM": {
    }
}

Response samples

Content type
application/json
{
  • "CloudHSM": {
    },
  • "is_ok": true
}

deleteCloudHSM

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

listCloudHSMPeers

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "Peers": [
    ],
  • "is_ok": true
}

createCloudHSMPeer

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (PeerRequest)

Responses

Request samples

Content type
application/json
{
  • "Peer": {
    }
}

deleteCloudHSMPeer

Authorizations:
basicAuth
path Parameters
peer_id
required
string
resource_id
required
string (リソースID)

Responses

listCloudHSMLicenses

Authorizations:
basicAuth
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "Licenses": [
    ],
  • "is_ok": true
}

createCloudHSMLicense

Authorizations:
basicAuth
Request Body schema: application/json
required
required
object (CreateCloudHSMSoftwareLicenseRequest)

Responses

Request samples

Content type
application/json
{
  • "License": {
    }
}

Response samples

Content type
application/json
{
  • "License": {
    },
  • "is_ok": true
}

listCloudHSMDocuments

Authorizations:
basicAuth
path Parameters
license_resource_id
required
string
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "CloudHSMDocuments": [
    ],
  • "is_ok": true
}

downloadCloudHSMDocument

Authorizations:
basicAuth
path Parameters
id
required
string

A unique value identifying this CloudHSMドキュメント.

license_resource_id
required
string

Responses

Response samples

Content type
application/json
{}

readCloudHSMLicense

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "License": {
    },
  • "is_ok": true
}

updateCloudHSMLicense

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (CloudHSMSoftwareLicenseRequest)

Responses

Request samples

Content type
application/json
{
  • "License": {
    }
}

Response samples

Content type
application/json
{
  • "License": {
    },
  • "is_ok": true
}

deleteCloudHSMLicense

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

kms-key

listKeys

Authorizations:
basicAuth
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "Keys": [
    ],
  • "is_ok": true
}

createKey

Authorizations:
basicAuth
Request Body schema: application/json
required
required
object (CreateKeyRequest)

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

readKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

updateKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (KeyRequest)

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

deleteKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

decryptDataWithKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (DecryptionRequest)

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

encryptDataWithKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (EncryptionRequest)

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

rotateKey

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

scheduleKeyDestruction

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (ScheduleDestructionKeyRequest)

鍵の削除スケジュール設定

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

changeKeyStatus

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (ChangeKeyStateRequest)

鍵の状態変更

Responses

Request samples

Content type
application/json
{
  • "Key": {
    }
}

Response samples

Content type
application/json
{
  • "Key": {
    },
  • "is_ok": true
}

secretmanager-vault

listVaults

Authorizations:
basicAuth
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "Vaults": [
    ],
  • "is_ok": true
}

createVault

Authorizations:
basicAuth
Request Body schema: application/json
required
required
object (CreateVaultRequest)

Responses

Request samples

Content type
application/json
{
  • "Vault": {
    }
}

Response samples

Content type
application/json
{
  • "Vault": {
    },
  • "is_ok": true
}

readVault

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

Response samples

Content type
application/json
{
  • "Vault": {
    },
  • "is_ok": true
}

updateVault

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)
Request Body schema: application/json
required
required
object (VaultRequest)

Responses

Request samples

Content type
application/json
{
  • "Vault": {
    }
}

Response samples

Content type
application/json
{
  • "Vault": {
    },
  • "is_ok": true
}

deleteVault

Authorizations:
basicAuth
path Parameters
resource_id
required
string (リソースID)

Responses

listVaultSecrets

Authorizations:
basicAuth
path Parameters
vault_resource_id
required
string
query Parameters
Count
integer

Number of results to return per page.

From
integer

The initial index from which to return the results.

Responses

Response samples

Content type
application/json
{
  • "Count": 10,
  • "From": 0,
  • "Total": 10,
  • "Secrets": [
    ],
  • "is_ok": true
}

createVaultSecret

新しいバージョンを作成します。シークレット値は最新を含む50世代まで保持され、より古い世代は削除されます。

Authorizations:
basicAuth
path Parameters
vault_resource_id
required
string
Request Body schema: application/json
required
required
object (CreateSecretRequest)

Responses

Request samples

Content type
application/json
{
  • "Secret": {
    }
}

Response samples

Content type
application/json
{
  • "Secret": {
    },
  • "is_ok": true
}

deleteVaultSecret

Authorizations:
basicAuth
path Parameters
vault_resource_id
required
string
Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "Secret": {
    }
}

unveilSecret

シークレット値を取得します。取得できるのは最新を含む50世代までです。

Authorizations:
basicAuth
path Parameters
vault_resource_id
required
string
Request Body schema: application/json
required
required
object (UnveilRequest)

Responses

Request samples

Content type
application/json
{
  • "Secret": {
    }
}

Response samples

Content type
application/json
{
  • "Secret": {
    },
  • "is_ok": true
}