한국(평촌) 리전## API v2 Preparations
The NHN Cloud Infrastructure Services API provides different endpoints for each type and region. However, the Identity API uses the same endpoint for all regions.
| Type | Region | Endpoint |
|---|---|---|
| identity | All Regions | https://api-identity-infrastructure.nhncloudservice.com |
| compute | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-instance-infrastructure.nhncloudservice.com https://kr2-api-instance-infrastructure.nhncloudservice.com https://jp1-api-instance-infrastructure.nhncloudservice.com https://us1-api-instance-infrastructure.nhncloudservice.com |
| network | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-network-infrastructure.nhncloudservice.com https://kr2-api-network-infrastructure.nhncloudservice.com https://jp1-api-network-infrastructure.nhncloudservice.com https://us1-api-network-infrastructure.nhncloudservice.com |
| image | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-image-infrastructure.nhncloudservice.com https://kr2-api-image-infrastructure.nhncloudservice.com https://jp1-api-image-infrastructure.nhncloudservice.com https://us1-api-image-infrastructure.nhncloudservice.com |
| volumev2 | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-block-storage-infrastructure.nhncloudservice.com https://kr2-api-block-storage-infrastructure.nhncloudservice.com https://jp1-api-block-storage-infrastructure.nhncloudservice.com https://us1-api-block-storage-infrastructure.nhncloudservice.com |
| object-store | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-object-storage.nhncloudservice.com https://kr2-api-object-storage.nhncloudservice.com https://jp1-api-object-storage.nhncloudservice.com https://us1-api-object-storage.nhncloudservice.com |
| key-manager | Korea (Pangyo) Region Korea (Pyeongchon) Region Japan Region US (California) Region |
https://kr1-api-key-manager-infrastructure.nhncloudservice.com https://kr2-api-key-manager-infrastructure.nhncloudservice.com https://jp1-api-key-manager-infrastructure.nhncloudservice.com https://us1-api-key-manager-infrastructure.nhncloudservice.com |
You can check your tenant ID to include in API requests from Set API Endpoint in Compute > Instance > Management.
You must set an API endpoint password, which is separate from your NHN Cloud account password, in order to use the NHN Cloud Infrastructure Services API. An API password is set by account. You can use the same password set in one project for all of your other projects.
[Caution] When changing your API password, you must obtain a new authentication token because the existing token is no longer available.
To obtain a token, use the identity type endpoint. The identity service endpoint is https://api-identity-infrastructure.nhncloudservice.com regardless of region.
You must obtain a token to make API calls. NHN Cloud uses project-scoped tokens.
[Caution] When a user loses permissions from a project, the credentials expire and become unavailable. If you leave NHN Cloud and your account is deleted, all credentials issued to that account will expire and become unavailable.
POST /v2.0/tokens
| Name | Type | Format | Required | Description |
|---|---|---|---|---|
| tenantId | Body | String | O | Tenant ID to obtain a token |
| passwordCredentials | Body | Object | O | User information for authentication |
| username | Body | String | O | NHN Cloud user ID (email format), IAM member ID |
| password | Body | String | O | API password |
Unfold
{
"auth": {
"tenantId": "f5073eaa26b64cffbee89411df94ce01",
"passwordCredentials": {
"username": "user@example.com",
"password": "secretsecret"
}
}
}
| Name | Type | Attributes | Description |
|---|---|---|---|
| access | Body | Object | access object |
| access.token | Body | Object | token object |
| access.token.issued_at | Body | Datetime | Token issuance time (UTC)YYYY-MM-DDThh:mm:ss.SSSSSS format |
| access.token.expires | Body | Datetime | Token expiration time (UTC)YYYY-MM-DDThh:mm:ssZ format |
| access.token.id | Body | String | Token ID |
| access.token.tenant | Body | Object | tenant object |
| access.token.tenant.description | Body | String | Tenant description |
| access.token.tenant.enabled | Body | Boolean | Indicates whether the tenant is enabled If disabled, unable to obtain token or make API calls |
| access.token.tenant.id | Body | String | Tenant ID |
| access.token.tenant.name | Body | String | Tenant name |
| access.serviceCatalog | Body | Object | serviceCatalog object |
| access.serviceCatalog.endpoints | Body | Object | endpoint object |
| access.serviceCatalog.endpoints_links | Body | String | Endpoint links |
| access.serviceCatalog.type | Body | String | Endpoint service type |
| access.serviceCatalog.name | Body | String | Endpoint service name |
| access.user | Body | Object | user object |
| access.metadata | Body | Object | metadata object |
Unfold
{
"access": {
"token": {
"id": "e42a092ed6ee4d99949bf25f5f6ecc60",
"expires": "2020-04-29T15:31:21Z",
"tenant": {
"id": "f5073eaa26b64cffbee89411df94ce01",
"name": "c_VKkasVsh",
"groupId": "XEj2zkHrbA7modGU",
"description": "",
"enabled": true,
"project_domain": "NORMAL"
},
"issued_at": "2020-04-29T03:32:28.000405"
},
"serviceCatalog": [
{
"endpoints": [
{
"region": "KR2",
"publicURL": "https://kr2-api-instance-infrastructure.nhncloudservice.com/v2/f5073eaa26b64cffbee89411df94ce01"
},
{
"region": "KR1",
"publicURL": "https://kr1-api-instance-infrastructure.nhncloudservice.com/v2/f5073eaa26b64cffbee89411df94ce01"
}
],
"type": "compute",
"name": "nova"
},
{
"endpoints": [
{
"region": "KR2",
"publicURL": "https://kr2-api-image-infrastructure.nhncloudservice.com"
},
{
"region": "KR1",
"publicURL": "https://kr1-api-image-infrastructure.nhncloudservice.com"
}
],
"type": "image",
"name": "glance"
},
{
"endpoints": [
{
"region": "KR1",
"publicURL": "https://api-identity-infrastructure.nhncloudservice.com/v2.0"
}
],
"type": "identity",
"name": "keystone"
},
{
"endpoints": [
{
"region": "KR2",
"publicURL": "https://kr2-api-key-manager-infrastructure.nhncloudservice.com"
},
{
"region": "KR1",
"publicURL": "https://kr1-api-key-manager-infrastructure.nhncloudservice.com"
}
],
"type": "key-manager",
"name": "barbican"
},
{
"endpoints": [
{
"region": "KR2",
"publicURL": "https://kr2-api-block-storage-infrastructure.nhncloudservice.com/v2/f5073eaa26b64cffbee89411df94ce01"
},
{
"region": "KR1",
"publicURL": "https://kr1-api-block-storage-infrastructure.nhncloudservice.com/v2/f5073eaa26b64cffbee89411df94ce01"
}
],
"type": "volumev2",
"name": "cinderv2"
},
{
"endpoints": [
{
"region": "KR2",
"publicURL": "https://kr2-api-network-infrastructure.nhncloudservice.com"
},
{
"region": "KR1",
"publicURL": "https://kr1-api-network-infrastructure.nhncloudservice.com"
}
],
"type": "network",
"name": "neutron"
}
],
"user": {
"id": "436f727b7c9142f896ddd56be591dd7f",
"username": "37be6ac0-d660-11e7-ae46-005056ac1497",
"name": "37be6ac0-d660-11e7-ae46-005056ac1497",
"roles": [
{
"name": "project_admin"
}
],
"roles_links": []
},
"metadata": {
"roles": [
"9fe2ff9ee4384b1894a90878d3e92bab"
],
"is_admin": 0
}
}
}