NHN Cloud 기본 인프라 서비스 API는 타입과 리전별로 엔드포인트가 나뉘어 있습니다. 단, Identity API는 모든 리전에서 동일한 엔드포인트를 사용합니다.
| 타입 | 리전 | 엔드포인트 |
|---|---|---|
| identity | 모든 리전 | https://api-identity-infrastructure.nhncloudservice.com |
| compute | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 | 한국(판교) 리전 한국(평촌) 리전 일본 리전 미국(캘리포니아) 리전 |
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 |
API 요청에 포함되는 테넌트 ID는 Compute > Instance > 관리 페이지의 API 엔드포인트 설정 대화 상자에서 확인합니다.
NHN Cloud 기본 인프라 서비스 API를 사용하려면 NHN Cloud 계정 비밀번호와는 별개로 API 비밀번호를 설정해야 합니다.
API 비밀번호는 계정별로 설정됩니다. 한 프로젝트에서 설정된 비밀번호는 사용자가 속한 모든 프로젝트에서 사용할 수 있습니다.
[주의]
API 비밀번호 변경 시 기존 인증 토큰은 더 이상 사용할 수 없으며 재발급이 필요합니다.
토큰 발급은 identity 타입 엔드포인트를 이용합니다. identity 서비스 엔드포인트는 리전에 관계없이 https://api-identity-infrastructure.nhncloudservice.com입니다.
API를 호출할 때 필요한 토큰을 발급받습니다. NHN Cloud에서는 프로젝트 한정 토큰(project-scoped token)을 사용합니다.
[주의]
사용자가 프로젝트에서 권한을 잃을 경우 해당 자격 증명은 만료되어 사용할 수 없습니다.
NHN Cloud를 탈퇴하여 계정이 삭제되는 경우 해당 계정으로 발급받은 모든 자격 증명은 만료되어 사용할 수 없습니다.
POST /v2.0/tokens
| 이름 | 종류 | 형식 | 필수 | 설명 |
|---|---|---|---|---|
| tenantId | Body | String | O | 토큰을 발급받을 테넌트 ID |
| passwordCredentials | Body | Object | O | 인증을 위한 사용자 정보 객체 |
| username | Body | String | O | NHN Cloud 회원 ID(이메일 형식), IAM 멤버 ID |
| password | Body | String | O | API 비밀번호 |
펼쳐 보기
{
"auth": {
"tenantId": "f5073eaa26b64cffbee89411df94ce01",
"passwordCredentials": {
"username": "user@example.com",
"password": "secretsecret"
}
}
}
| 이름 | 종류 | 속성 | 설명 |
|---|---|---|---|
| access | Body | Object | access 객체 |
| access.token | Body | Object | token 객체 |
| access.token.issued_at | Body | Datetime | 토큰 발급 시간(UTC)YYYY-MM-DDThh:mm:ss.SSSSSS의 형태 |
| access.token.expires | Body | Datetime | 토큰 만료 시간(UTC)YYYY-MM-DDThh:mm:ssZ의 형태 |
| access.token.id | Body | String | 토큰 ID |
| access.token.tenant | Body | Object | tenant 객체 |
| access.token.tenant.description | Body | String | 테넌트 설명 |
| access.token.tenant.enabled | Body | String | 테넌트의 활성화 여부 활성화되지 않으면 토큰 발급 및 API 호출 불가 |
| access.token.tenant.id | Body | String | 테넌트 ID |
| access.token.tenant.name | Body | String | 테넌트 이름 |
| access.serviceCatalog | Body | Object | serviceCatalog 객체 |
| access.serviceCatalog.endpoints | Body | Object | endpoint 객체 |
| access.serviceCatalog.endpoints_links | Body | String | 엔드포인트 링크 |
| access.serviceCatalog.type | Body | String | 엔드포인트 서비스 타입 |
| access.serviceCatalog.name | Body | String | 엔드포인트 서비스 이름 |
| access.user | Body | Object | user 객체 |
| access.metadata | Body | Object | metadata 객체 |
펼쳐 보기
{
"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
}
}
}