Skip to content

Commit fab1f7a

Browse files
update README.md (#93)
update README.md Reviewed-by: Artem Lifshits
1 parent 69ef622 commit fab1f7a

File tree

1 file changed

+89
-2
lines changed

1 file changed

+89
-2
lines changed

README.md

Lines changed: 89 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,94 @@
33

44
[![codecov.io](https://codecov.io/github/opentelekomcloud/oms/coverage.svg?branch=master)](https://codecov.io/github/opentelekomcloud/oms?branch=master)
55

6-
This is JS SDK designed for internal usage (mostly, for Rancher drivers' UI)
6+
This is JS SDK designed mostly for internal usage and for Rancher drivers' UI part (https://github.com/opentelekomcloud/ui-cluster-driver-otc)
77

8-
### Example
8+
Supports `ak/sk`, `token`, and `username/password` authentication.
9+
10+
#### Services list:
11+
- Compute:
12+
- V1:
13+
- List all available flavors by `listFlavors`
14+
- V2:
15+
- List all available for user Keypairs by `listKeyPairs`
16+
- Identity:
17+
- V3:
18+
- List available service endpoints by `listEndpoints`
19+
- Create permanent AK/SK by `getAKSK`
20+
- List available service catalog by `listCatalog`
21+
- List available projects (tenants) by `listProjects`
22+
- List available services by `listServices`
23+
- Get permanent auth token by `issueToken`
24+
- Image:
25+
- V2:
26+
- List all available images by `listImages`
27+
- Network
28+
- Get list of all existing VPCs by `listVPCs`
29+
- Create new VPC by `createVPC`
30+
- Get existing VPC details by `getVPC`
31+
- Update existing VPC by `updateVPC`
32+
- Delete existing VPC by `deleteVPC`
33+
- List existing subnets by `listSubnets`
34+
- Get existing subnet by ID by `getSubnet`
35+
- Create new subnet with given opts by `createSubnet`
36+
- Delete existing subnet by ID by `deleteSubnet`
37+
- List existing security groups by `listSecurityGroups`
38+
- Create new security group by `createSecurityGroup`
39+
- Delete existing security group by `deleteSecurityGroup`
40+
- List all public IPs assigned to the project by `listPublicIPs`
41+
- Object-storage
42+
- V1:
43+
- Get AccountMetadata details and container list by `getAccount`
44+
- Get AccountMetadata details by `showAccountMetadata`
45+
- Update account metadata by `updateAccountMetadata`
46+
- Create container by `createContainer`
47+
- List all containers by `listContainers`
48+
- Show container metadata by `showContainerMetadata`
49+
- List container objects by `getContainer`
50+
- Delete container by `deleteContainer`
51+
52+
### Usage:
53+
54+
1. ***Create cloud config with necessary with auth url:***
55+
56+
const authUrl = "https://iam.eu-de.otc.t-systems.com/v3"
57+
58+
const config = cloud(authUrl)
59+
2. ***Add auth type:***
60+
1) With AK/SK and Project:
61+
62+
config.withAKSK("ak", "sk").withProject("projectName")
63+
2) With Auth token:
64+
65+
config.withToken("token")
66+
3) With username and password (`region` here is mandatory):
67+
68+
config.withRegion("region").withProject("projectName").withPassword("domainName", "username", "password")
69+
3. ***Create client form config:***
70+
71+
const client = new Client(config.config)
72+
73+
await client.authenticate()
74+
75+
const catalog = await client.getService(IdentityV3).listCatalog()
76+
77+
### Usage example:
978
Minimal usage example can be found at https://github.com/opentelekomcloud-blueprints/oms-example
79+
80+
### Published in NPM:
81+
- https://www.npmjs.com/package/@opentelekomcloud/oms
82+
83+
## License
84+
Copyright 2023 T-Systems GmbH
85+
86+
Licensed under the Apache License, Version 2.0 (the "License");
87+
you may not use this file except in compliance with the License.
88+
You may obtain a copy of the License at
89+
90+
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
91+
92+
Unless required by applicable law or agreed to in writing, software
93+
distributed under the License is distributed on an "AS IS" BASIS,
94+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
95+
See the License for the specific language governing permissions and
96+
limitations under the License.

0 commit comments

Comments
 (0)