sjkp/armclient-go repository overview
armclient
A simple command line tool to invoke the Azure Resource Manager API from any OS. Inspired by original windows version ARMClient (https://github.com/projectkudu/ARMClient).
Why we need this
I always loved the windows version ARMClient. It is super useful when exploring Azure Resource Manager APIs. You just work with ARM's REST API directly and with --verbose flag to see the raw request & response with headers.
When I started working on a non-windows platform, there wasn't a similar tool available. Existing ARMClient code is based on a full .NET framework and winform thus porting to .NET Core required siginificant changes. You can do a curl but it's too much work and you still need to handle the Azure AD login manually. So I decided to implement one in Golang and release it for Windows, Linux and MacOS.
Highlights
- Integrated with Azure Cloud Shell. When running armclient in Cloud Shell, sign-in will be taken care automatically. No sign in needed, just run after you install it.
Installation
armclient is just one binary, just copy and use it.
For Linux:
curl -sL https://github.com/yangl900/armclient-go/releases/download/v0.2.3/armclient-go_linux_64-bit.tar.gz | tar xz
For Windows (In PowerShell):
curl https://github.com/yangl900/armclient-go/releases/download/v0.2.3/armclient-go_windows_64-
bit.zip -OutFile armclient.zip
And unzip the file, the only binary needed is armclient.exe.
For MacOS:
Use Homebrew
brew install yangl900/armclient-go/armclient-go
or use a released binary:
curl -sL https://github.com/yangl900/armclient-go/releases/download/v0.2.3/armclient-go_macOS_64-bit.tar.gz | tar xz
How to use it
Syntax is exactly the same as the original ARMClient. To GET your subscriptions, simply run
armclient get /subscriptions?api-version=2018-01-01
Output is JSON returned from the Azure Resource Manager endpoint, e.g.
{
"value": [
{
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
"subscriptionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
"displayName": "Visual Studio Ultimate with MSDN",
"state": "Enabled",
"subscriptionPolicies": {
"locationPlacementId": "Public_2014-09-01",
"quotaId": "MSDN_2014-09-01",
"spendingLimit": "On"
}
}
]
}
If more details of the request are needed, add --verbose flag
---------- Request -----------------------
GET https://management.azure.com/subscriptions?api-version=2015-01-01
Host: management.azure.com
Authorization: Bearer eyJ0eXAi...
User-Agent: github.com/yangl900/armclient-go
Accept: application/json
x-ms-client-request-id: 9e6cceb1-8a4e-40eb-9701-11d341150220
---------- Response (215ms) ------------
HTTP/1.1: 200 OK
cache-control: no-cache
pragma: no-cache
expires: -1
x-ms-request-id: 64e0fc41-98a3-42c4-808a-ef2fcb7e688c
x-ms-correlation-request-id: 64e0fc41-98a3-42c4-808a-ef2fcb7e688c
x-ms-routing-request-id: WESTUS:20180207T075009Z:64e0fc41-98a3-42c4-808a-ef2fcb7e688c
date: Wed, 07 Feb 2018 07:50:08 GMT
content-type: application/json; charset=utf-8
strict-transport-security: max-age=31536000; includeSubDomains
vary: Accept-Encoding
x-ms-ratelimit-remaining-tenant-reads: 14998
{
"value": [
{
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
"subscriptionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx",
"displayName": "Visual Studio Ultimate with MSDN",
"state": "Enabled",
"subscriptionPolicies": {
"locationPlacementId": "Public_2014-09-01",
"quotaId": "MSDN_2014-09-01",
"spendingLimit": "On"
}
}
]
}
To print out the current tenant access token claims, run
armclient token
Output looks like the following. A token will also be copied to your clipboard automatically (if available). Linux environments require xclip to be installed for the clipboard copy.
{
"aud": "https://management.core.windows.net/",
"iss": "https://sts.windows.net/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx/",
"iat": 1518072605,
"nbf": 1518072605,
"exp": 1518076505,
"acr": "1",
"appid": "04b07795-8ddb-461a-bbee-02f9e1bf7b46",
"appidacr": "0",
"idp": "live.com",
"name": "Anders Liu",
"scp": "user_impersonation",
"ver": "1.0"
}
To print out the raw JWT token, run
armclient token -r
To print the access token of a different tenant use the --tenant parameter
armclient token --tenant {tenantId or name}
Input for request body
There are 2 ways to specify an input for a request body, let's take a resource group creation as an example. You can do one of the following.
- Inline the request body in the command line
armclient put /subscriptions/{subscription}/resourceGroups/{resourceGroup}?api-version=2018-01-01 "{'location':'westus'}"
- Save the request body in a JSON file and use @ as a parameter
armclient put /subscriptions/{subscription}/resourceGroups/{resourceGroup}?api-version=2018-01-01 @./resourceGroup.json
Add additional request headers
Use flag --header or -H for additional request headers. For example:
armclient get /subscriptions?api-version=2018-01-01 -H Custom-Header=my-header-value-123 --verbose
Target ARM endpoint in a specific region
The absolute URI is accepted, so just specify the complete URI:
armclient get https://westus.management.azure.com/subscriptions?api-version=2018-01-01
Working with multiple Azure AD Directories (tenants)
To list all tenants you have access to:
armclient tenant list
To set a tenant as your active tenant (defaults to the first tenant):
armclient tenant set {tenantID}
To show the current active tenant:
armclient tenant show
Exploring Azure APIs
For more REST API references please see Azure REST API documentation. The original ARMClient wiki also has good references.
Contribution
Build the project
make
Add dependency
dep ensure
Credits
- thanks @jeffhollan to enable token copy to clipboard
- thanks @luanshixia to enable Homebrew installation
Tag summary
Content type
Image
Digest
Size
74.8 MB
Last updated
over 7 years ago
docker pull sjkp/armclient-go