7장. ID 서비스 명령줄 클라이언트
주의
keystone CLI는 python-openstackclient 대신 더 이상 사용되지 않습니다. python-openstackclient에 대한 자세한 내용은 3.3절. “하위 명령” 에서 참조하십시오. Python 라이브러리의 경우 python-keystoneclient를 계속 사용합니다.
keystone 클라이언트는 ID 서비스 API 및 해당 확장의 CLI(명령줄 인터페이스)입니다. 이 장에서는 keystone 버전
1.7.2
를 문서화합니다.
특정 keystone 명령에 대한 도움말을 보려면 다음을 입력합니다.
$
keystone
help
COMMAND
7.1. Keystone 사용
usage: keystone [--version] [--debug] [--os-username <auth-user-name>] [--os-password <auth-password>] [--os-tenant-name <auth-tenant-name>] [--os-tenant-id <tenant-id>] [--os-auth-url <auth-url>] [--os-region-name <region-name>] [--os-identity-api-version <identity-api-version>] [--os-token <service-token>] [--os-endpoint <service-endpoint>] [--os-cache] [--force-new-token] [--stale-duration <seconds>] [--insecure] [--os-cacert <ca-certificate>] [--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>] <subcommand> ...
하위 명령
- catalog
- 서비스 카탈로그 나열, 서비스별로 필터링할 수 있습니다.
- ec2-credentials-create
- 사용자당 테넌트당 EC2 호환 인증 정보를 생성합니다.
- ec2-credentials-delete
- EC2 호환 인증 정보를 삭제합니다.
- ec2-credentials-get
- EC2 호환 인증 정보를 표시합니다.
- ec2-credentials-list
- 사용자의 EC2 호환 인증 정보를 나열합니다.
- endpoint-create
- 서비스와 연결된 새 엔드포인트를 생성합니다.
- endpoint-delete
- 서비스 엔드포인트를 삭제합니다.
- endpoint-get
- 특정 특성 또는 서비스 유형으로 필터링된 엔드포인트를 찾습니다.
- endpoint-list
- 구성된 서비스 엔드포인트를 나열합니다.
- password-update
- 자신의 암호를 업데이트합니다.
- role-create
- 새 역할을 생성합니다.
- role-delete
- 역할 삭제.
- role-get
- 역할 세부 정보를 표시합니다.
- role-list
- 모든 역할을 나열합니다.
- service-create
- 서비스 카탈로그에 서비스를 추가합니다.
- service-delete
- 서비스 카탈로그에서 서비스를 삭제합니다.
- service-get
- 서비스 카탈로그에서 서비스를 표시합니다.
- service-list
- 서비스 카탈로그의 모든 서비스를 나열합니다.
- tenant-create
- 새 테넌트 만들기.
- tenant-delete
- 테넌트를 삭제합니다.
- tenant-get
- 테넌트 세부 정보를 표시합니다.
- tenant-list
- 모든 테넌트를 나열합니다.
- tenant-update
- 테넌트 이름, 설명, 활성화된 상태를 업데이트합니다.
- token-get
- 현재 사용자 토큰을 표시합니다.
- user-create
- 새 사용자를 만듭니다.
- user-delete
- 사용자를 삭제합니다.
- user-get
- 사용자 세부 정보를 표시합니다.
- user-list
- 사용자를 나열합니다.
- user-password-update
- 사용자 암호를 업데이트합니다.
- user-role-add
- 사용자에 역할을 추가합니다.
- user-role-list
- 사용자에게 부여된 역할을 나열합니다.
- user-role-remove
- 사용자에서 역할을 제거합니다.
- user-update
- 사용자 이름, 이메일 및 활성화된 상태를 업데이트합니다.
- Discover
- Keystone 서버, 지원되는 API 버전 및 확장을 검색합니다.
- 부트스트랩
- 각각 생성한 후 새 테넌트의 새 사용자에게 새 역할을 부여합니다.
- bash-completion
- 모든 명령과 옵션을 stdout에 출력합니다.
- help
- 이 프로그램 또는 하위 명령에 대한 도움말을 표시합니다.
7.2. Keystone 선택적 인수
- --version
- 클라이언트 버전을 표시하고 종료합니다.
- --debug
- 콘솔에 디버깅 출력을 출력합니다. 여기에는 curl 요청 및 응답 호출이 포함됩니다. API 호출을 디버깅하고 이해하는 데 유용합니다.
- --os-username <auth-user-name>
- OpenStack ID 서비스를 사용한 인증에 사용되는 이름입니다. 기본값은
env[OS_USERNAME]
입니다. - --os-password <auth-password>
- OpenStack ID 서비스를 사용한 인증에 사용되는 암호입니다. 기본값은
env[OS_PASSWORD]
입니다. - --os-tenant-name <auth-tenant-name>
- 테넌트에서 권한을 요청합니다. 기본값은
env[OS_TENANT_NAME]
입니다. - --os-tenant-id <tenant-id>
- 테넌트에서 권한을 요청합니다. 기본값은
env[OS_TENANT_ID]
입니다. - --os-auth-url <auth-url>
- 인증에 사용할 ID 끝점을 지정합니다. 기본값은
env[OS_AUTH_URL]
입니다. - --os-region-name <region-name>
- 사용할 리전을 지정합니다. 기본값은
env[OS_REGION_NAME]
입니다. - --os-identity-api-version <identity-api-version>
- 사용할 ID API 버전을 지정합니다. 기본값은
env[OS_IDENTITY_API_VERSION]
또는 2.0입니다. - --os-token <service-token>
- 인증을 통해 검색하는 대신 사용할 기존 토큰을 지정합니다(예: 사용자 이름 및 암호 사용). 기본값은
env[OS_SERVICE_TOKEN]
입니다. - --os-endpoint <service-endpoint>
- 서비스 카탈로그에서(인증을 통해)을 검색하는 대신 사용할 끝점을 지정합니다. 기본값은
env[OS_SERVICE_ENDPOINT]
입니다. - --os-cache
- 인증 토큰 캐시를 사용합니다. 기본값은
env[OS_CACHE]
입니다. - --force-new-token
- 인증 키를 사용할 수 있고 사용 중인 경우 토큰이 만료될 때까지 인증 키에서 토큰을 항상 저장하고 가져옵니다. 새 토큰을 요청하고 인증 키의 기존 토큰을 교체하려면 이 옵션을 사용합니다.
- --stale-duration <seconds>
- 인증 키에서 검색할 때 토큰이 만료되었는지 확인하는 데 사용되는 오래된 기간(초)입니다. 이 기능은 프로세스 또는 네트워크 지연을 완화하는 데 유용합니다. 기본값은 30초입니다.
- --insecure
- 명시적으로 클라이언트가 "비보안" TLS(https) 요청을 수행할 수 있습니다. 서버의 인증서는 인증 기관에 대해 확인되지 않습니다. 이 옵션은 주의해서 사용해야 합니다.
- --os-cacert <ca-certificate>
- TLS(https) 서버 인증서를 확인하는 데 사용할 CA 번들 파일을 지정합니다. 기본값은
env[OS_CACERT]
입니다. - --os-cert <certificate>
- 기본값은
env[OS_CERT]
입니다. - --os-key <key>
- 기본값은
env[OS_KEY]
입니다. - --timeout <seconds>
- 요청 제한 시간(초)을 설정합니다.
7.3. Keystone 부트스트랩
usage: keystone bootstrap [--user-name <user-name>] --pass <password> [--role-name <role-name>] [--tenant-name <tenant-name>]
각각 생성한 후 새 테넌트의 새 사용자에게 새 역할을 부여합니다.
인수
- --user-name <user-name>
- 생성할 사용자의 이름(default="admin").
- --pass <password>
- 새 사용자의 암호입니다.
- --role-name <role-name>
- 사용자에게 생성 및 부여되는 역할의 이름입니다(default="admin").
- --tenant-name <tenant-name>
- 생성할 테넌트의 이름(default="admin").
7.4. Keystone 카탈로그
usage: keystone catalog [--service <service-type>]
서비스 카탈로그 나열, 서비스별로 필터링할 수 있습니다.
인수
- --service <service-type>
- 반환할 서비스 유형입니다.
7.5. Keystone discover
usage: keystone discover
Keystone 서버, 지원되는 API 버전 및 확장을 검색합니다.
7.6. Keystone ec2-credentials-create
usage: keystone ec2-credentials-create [--user-id <user-id>] [--tenant-id <tenant-id>]
사용자당 테넌트당 EC2 호환 인증 정보를 생성합니다.
인수
- --user-id <user-id>
- 자격 증명을 생성할 사용자 ID입니다. 지정하지 않으면 인증된 사용자가 사용됩니다.
- --tenant-id <tenant-id>
- 자격 증명을 만들 테넌트 ID입니다. 지정하지 않으면 인증된 테넌트 ID가 사용됩니다.
7.7. Keystone ec2-credentials-delete
usage: keystone ec2-credentials-delete [--user-id <user-id>] --access <access-key>
EC2 호환 인증 정보를 삭제합니다.
인수
- --user-id <user-id>
- 사용자 ID.
- --access <access-key>
- 액세스 키.
7.8. Keystone ec2-credentials-get
usage: keystone ec2-credentials-get [--user-id <user-id>] --access <access-key>
EC2 호환 인증 정보를 표시합니다.
인수
- --user-id <user-id>
- 사용자 ID.
- --access <access-key>
- 액세스 키.
7.9. Keystone ec2-credentials-list
usage: keystone ec2-credentials-list [--user-id <user-id>]
사용자의 EC2 호환 인증 정보를 나열합니다.
인수
- --user-id <user-id>
- 사용자 ID.
7.10. Keystone endpoint-create
usage: keystone endpoint-create [--region <endpoint-region>] --service <service> --publicurl <public-url> [--adminurl <admin-url>] [--internalurl <internal-url>]
서비스와 연결된 새 엔드포인트를 생성합니다.
인수
- --region <endpoint-region>
- 엔드포인트 리전.
- --service <service>, --service-id <service>, --service_id <service>
- 엔드포인트와 연결된 서비스의 이름 또는 ID입니다.
- --publicurl <public-url>
- 공용 URL 끝점.
- --adminurl <admin-url>
- 관리자 URL 끝점.
- --internalurl <internal-url>
- 내부 URL 끝점.
7.11. Keystone endpoint-delete
usage: keystone endpoint-delete <endpoint-id>
서비스 엔드포인트를 삭제합니다.
인수
- <endpoint-id>
- 삭제할 끝점의 ID입니다.
7.12. Keystone endpoint-get
usage: keystone endpoint-get --service <service-type> [--endpoint-type <endpoint-type>] [--attr <service-attribute>] [--value <value>]
특정 특성 또는 서비스 유형으로 필터링된 엔드포인트를 찾습니다.
인수
- --service <service-type>
- 선택할 서비스 유형입니다.
- --endpoint-type <endpoint-type>
- 선택할 끝점 유형입니다.
- --attr <service-attribute>
- 선택과 일치해야 하는 서비스 속성입니다.
- --value <value>
- 일치시킬 속성의 값입니다.
7.13. Keystone endpoint-list
usage: keystone endpoint-list
구성된 서비스 엔드포인트를 나열합니다.
7.14. Keystone password-update
usage: keystone password-update [--current-password <current-password>] [--new-password <new-password>]
자신의 암호를 업데이트합니다.
인수
- --current-password <current-password>
- 현재 암호, --os-password 또는
env[OS_PASSWORD]
에 설정된 암호의 기본값입니다. - --new-password <new-password>
- 원하는 새 암호입니다.
7.15. Keystone role-create
usage: keystone role-create --name <role-name>
새 역할을 생성합니다.
인수
- --name <role-name>
- 새 역할의 이름입니다.
7.16. Keystone role-delete
usage: keystone role-delete <role>
역할 삭제.
인수
- <role>
- 삭제할 역할의 이름 또는 ID입니다.
7.17. Keystone role-get
usage: keystone role-get <role>
역할 세부 정보를 표시합니다.
인수
- <role>
- 표시할 역할의 이름 또는 ID입니다.
7.18. Keystone role-list
usage: keystone role-list
모든 역할을 나열합니다.
7.19. Keystone service-create
usage: keystone service-create --type <type> [--name <name>] [--description <service-description>]
서비스 카탈로그에 서비스를 추가합니다.
인수
- --type <type>
- 서비스 유형(ID, compute, network, image, object-store 또는 기타 서비스 식별자 문자열 중 하나).
- --name <name>
- 새 서비스 이름(Unique)이어야 합니다.
- --description <service-description>
- 서비스에 대한 설명입니다.
7.20. Keystone service-delete
usage: keystone service-delete <service>
서비스 카탈로그에서 서비스를 삭제합니다.
인수
- <service>
- 삭제할 서비스의 이름 또는 ID입니다.
7.21. Keystone service-get
usage: keystone service-get <service>
서비스 카탈로그에서 서비스를 표시합니다.
인수
- <service>
- 표시할 서비스의 이름 또는 ID입니다.
7.22. Keystone service-list
usage: keystone service-list
서비스 카탈로그의 모든 서비스를 나열합니다.
7.23. Keystone tenant-create
usage: keystone tenant-create --name <tenant-name> [--description <tenant-description>] [--enabled <true|false>]
새 테넌트 만들기.
인수
- --name <tenant-name>
- 새 테넌트 이름(Unique)이어야 합니다.
- --description <tenant-description>
- 새 테넌트에 대한 설명입니다. 기본값은 none입니다.
- --enabled <true|false>
- 초기 테넌트 활성화 상태. 기본값은 true입니다.
7.24. Keystone tenant-delete
usage: keystone tenant-delete <tenant>
테넌트를 삭제합니다.
인수
- <tenant>
- 삭제할 테넌트의 이름 또는 ID입니다.
7.25. Keystone tenant-get
usage: keystone tenant-get <tenant>
테넌트 세부 정보를 표시합니다.
인수
- <tenant>
- 표시할 테넌트의 이름 또는 ID입니다.
7.26. Keystone tenant-list
usage: keystone tenant-list
모든 테넌트를 나열합니다.
7.27. Keystone tenant-update
usage: keystone tenant-update [--name <tenant_name>] [--description <tenant-description>] [--enabled <true|false>] <tenant>
테넌트 이름, 설명, 활성화된 상태를 업데이트합니다.
인수
- --name <tenant_name>
- 테넌트의 새 이름이 필요합니다.
- --description <tenant-description>
- 테넌트에 대한 새로운 설명이 필요합니다.
- --enabled <true|false>
- 테넌트를 활성화 또는 비활성화합니다.
- <tenant>
- 업데이트할 테넌트의 이름 또는 ID입니다.
7.28. Keystone token-get
usage: keystone token-get [--wrap <integer>]
현재 사용자 토큰을 표시합니다.
인수
- --wrap <integer>
- PKI 토큰을 지정된 길이로 래핑하거나 비활성화하려면 0으로 래핑합니다.
7.29. Keystone user-create
usage: keystone user-create --name <user-name> [--tenant <tenant>] [--pass [<pass>]] [--email <email>] [--enabled <true|false>]
새 사용자를 만듭니다.
인수
- --name <user-name>
- 새 사용자 이름(Unique)이어야 합니다.
- --tenant <tenant>, --tenant-id <tenant>
- 새 사용자 기본 테넌트.
- --pass [<pass>]
- 새 사용자 암호; 일부 인증 백엔드에 필요합니다.
- --email <email>
- 새 사용자 이메일 주소입니다.
- --enabled <true|false>
- 초기 사용자 활성화 상태. 기본값은 true입니다.
7.30. Keystone user-delete
usage: keystone user-delete <user>
사용자를 삭제합니다.
인수
- <user>
- 삭제할 사용자의 이름 또는 ID입니다.
7.31. Keystone user-get
usage: keystone user-get <user>
사용자 세부 정보를 표시합니다.
인수
- <user>
- 표시할 사용자의 이름 또는 ID입니다.
7.32. Keystone user-list
usage: keystone user-list [--tenant <tenant>]
사용자를 나열합니다.
인수
- --tenant <tenant>, --tenant-id <tenant>
- tenant;을(를) 지정하지 않는 경우 모든 사용자를 나열합니다.
7.33. Keystone user-password-update
usage: keystone user-password-update [--pass <password>] <user>
사용자 암호를 업데이트합니다.
인수
- --pass <password>
- 원하는 새 암호입니다.
- <user>
- 암호를 업데이트할 사용자의 이름 또는 ID입니다.
7.34. Keystone user-role-add
usage: keystone user-role-add --user <user> --role <role> [--tenant <tenant>]
사용자에 역할을 추가합니다.
인수
- --user <user>, --user-id <user>, --user_id <user>
- 사용자의 이름 또는 ID입니다.
- --role <role>, --role-id <role>, --role_id <role>
- 역할의 이름 또는 ID입니다.
- --tenant <tenant>, --tenant-id <tenant>
- 테넌트의 이름 또는 ID입니다.
7.35. Keystone user-role-list
usage: keystone user-role-list [--user <user>] [--tenant <tenant>]
사용자에게 부여된 역할을 나열합니다.
인수
- --user <user>, --user-id <user>
- 지정된 사용자에게 부여된 역할을 나열합니다.
- --tenant <tenant>, --tenant-id <tenant>
- 지정된 테넌트에 부여된 역할만 나열합니다.
7.36. Keystone user-role-remove
usage: keystone user-role-remove --user <user> --role <role> [--tenant <tenant>]
사용자에서 역할을 제거합니다.
인수
- --user <user>, --user-id <user>, --user_id <user>
- 사용자의 이름 또는 ID입니다.
- --role <role>, --role-id <role>, --role_id <role>
- 역할의 이름 또는 ID입니다.
- --tenant <tenant>, --tenant-id <tenant>
- 테넌트의 이름 또는 ID입니다.
7.37. Keystone user-update
usage: keystone user-update [--name <user-name>] [--email <email>] [--enabled <true|false>] <user>
사용자 이름, 이메일 및 활성화된 상태를 업데이트합니다.
인수
- --name <user-name>
- 원하는 새 사용자 이름입니다.
- --email <email>
- 원하는 새 이메일 주소입니다.
- --enabled <true|false>
- 사용자를 활성화 또는 비활성화합니다.
- <user>
- 업데이트할 사용자의 이름 또는 ID입니다.