Querying Details of an Organization
Description
Query the details about an organization.
Constraints
None
API Calling
For details, see Calling APIs.
Authorization Information
Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.
- If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.
URI
GET /v2/manage/namespaces/{namespace}
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
namespace |
Yes |
String |
Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
Content-Type |
Yes |
String |
Message body type (format). The value can be application/json or charset=utf-8 application/json. Default value: application/json |
|
X-Auth-Token |
Yes |
String |
User token. The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
Integer |
id |
|
name |
String |
Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. |
|
creator_name |
String |
IAM username. |
|
auth |
Integer |
User permissions. 7: manage. 3: edit. 1: read. |
Example Request
GET https://{endpoint}/v2/manage/namespaces/{namespace}
Example Response
Status code: 200
Query succeeded.
{
"id" : 1422,
"name" : "demo",
"creator_name" : "lgp",
"auth" : 7
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
Query succeeded. |
|
400 |
Request error. |
|
401 |
Authentication failed. |
|
404 |
Organization not found. |
|
500 |
Internal error. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.