lib/fog/azurerm/docs/resources.md in fog-azure-rm-0.3.7 vs lib/fog/azurerm/docs/resources.md in fog-azure-rm-0.3.8
- old
+ new
@@ -1,8 +1,8 @@
-#Resources
+# Resources
-This document explains how to get started using Azure Resources Service with Fog. With this gem you can create/update/list/delete resource groups.
+This document explains how to get started using Azure Resources Service with Fog. With this gem you can create, update, list or delete resource groups.
## Usage
First of all, you need to require the Fog library by executing:
@@ -13,166 +13,166 @@
## Create Connection
Next, create a connection to the Resources Service:
```ruby
- azure_resources_service = Fog::Resources::AzureRM.new(
- tenant_id: '<Tenantid>', # Tenant id of Azure Active Directory Application
- client_id: '<Clientid>', # Client id of Azure Active Directory Application
- client_secret: '<ClientSecret>', # Client Secret of Azure Active Directory Application
- subscription_id: '<Subscriptionid>', # Subscription id of an Azure Account
- environment: '<AzureCloud/AzureChinaCloud/AzureUSGovernment/AzureGermanCloud>' # Azure cloud environment. Default is AzureCloud.
+fog_resources_service = Fog::Resources::AzureRM.new(
+ tenant_id: '<Tenant Id>', # Tenant Id of Azure Active Directory Application
+ client_id: '<Client Id>', # Client Id of Azure Active Directory Application
+ client_secret: '<Client Secret>', # Client Secret of Azure Active Directory Application
+ subscription_id: '<Subscription Id>', # Subscription Id of an Azure Account
+ environment: '<AzureCloud/AzureChinaCloud/AzureUSGovernment/AzureGermanCloud>' # Azure cloud environment. Default is AzureCloud.
)
```
## Check Resource Group Existence
```ruby
- azure_resources_service.resource_groups.check_resource_group_exists(<Resource Group name>)
+fog_resources_service.resource_groups.check_resource_group_exists('<Resource Group Name>')
```
## Create Resource Group
Create a new resource group
```ruby
- azure_resources_service.resource_groups.create(
+fog_resources_service.resource_groups.create(
name: '<Resource Group name>',
location: '<Location>',
- tags: { key1: "value1", key2: "value2", keyN: "valueN" } # [Optional]
- )
+ tags: { key1: 'value1', key2: 'value2', keyN: 'valueN' } # [Optional]
+)
```
## List Resource Groups
```ruby
- azure_resources_service.resource_groups.each do |resource_group|
+fog_resources_service.resource_groups.each do |resource_group|
puts "#{resource_group.name}"
puts "#{resource_group.location}"
- end
+end
```
## Retrieve a single Resource Group
Get a single record of Resource Group
```ruby
- resource_group = azure_resources_service
+resource_group = fog_resources_service
.resource_groups
- .get('<Resource Group name>')
- puts "#{resource_group.name}"
+ .get('<Resource Group Name>')
+puts "#{resource_group.name}"
```
## Destroy a single Resource Group
Get resource group object from the get method(described above) and then destroy that resource group.
```ruby
- resource_group.destroy
+resource_group.destroy
```
## Tagging a Resource
You can tag a Resource as following:
```ruby
- azure_resources_service.tag_resource(
- '<Resource-ID>',
- '<Tag-Key>',
- '<Tag-Value>',
- '<API-Version>'
- )
+fog_resources_service.tag_resource(
+ '<Resource Id>',
+ '<Tag Key>',
+ '<Tag Value>',
+ '<API Version>'
+)
```
## List Tagged Resources in a Subscription
```ruby
- azure_resources_service.azure_resources(tag_name: '<Tag-Key>', tag_value: '<Tag-Value>').each do |resource|
+fog_resources_service.azure_resources(tag_name: '<Tag Key>', tag_value: '<Tag Value>').each do |resource|
puts "#{resource.name}"
puts "#{resource.location}"
puts "#{resource.type}"
- end
+end
```
OR
```ruby
- azure_resources_service.azure_resources(tag_name: '<Tag-Key>').each do |resource|
+fog_resources_service.azure_resources(tag_name: '<Tag Key>').each do |resource|
puts "#{resource.name}"
puts "#{resource.location}"
puts "#{resource.type}"
- end
+end
```
## Retrieve a single Resource
Get a single record of Tagged Resources
```ruby
- resource = azure_resources_service
- .azure_resources(tag_name: '<Tag-Key>')
- .get('<Resource-ID>')
- puts "#{resource.name}"
+resource = fog_resources_service
+ .azure_resources(tag_name: '<Tag Key>')
+ .get('<Resource Id>')
+puts "#{resource.name}"
```
## Remove tag from a Resource
Remove tag from a resource as following:
```ruby
- azure_resources_service.delete_resource_tag(
- '<Resource-ID>',
- '<Tag-Key>',
- '<Tag-Value>',
- '<API-Version>'
- )
+fog_resources_service.delete_resource_tag(
+ '<Resource Id>',
+ '<Tag Key>',
+ '<Tag Value>',
+ '<API Version>'
+)
```
## Check Resource Existence
```ruby
- azure_resources_service.azure_resources.check_azure_resource_exists(<Resource-ID>, <API-Version>)
+fog_resources_service.azure_resources.check_azure_resource_exists('<Resource Id>', '<API Version>')
```
## Check Deployment Existence
```ruby
- azure_resources_service.deployments.check_deployment_exists(<Resource Group Name>, <Deployment name>)
+fog_resources_service.deployments.check_deployment_exists('<Resource Group Name>', '<Deployment Name>')
```
## Create Deployment
Create a Deployment
```ruby
- azure_resources_service.deployments.create(
- name: '<Deployment name>',
- resource_group: '<Resource Group name>',
+fog_resources_service.deployments.create(
+ name: '<Deployment Name>',
+ resource_group: '<Resource Group Name>',
template_link: '<Template Link>',
parameters_link: '<Parameters Link>'
- )
+)
```
## List Deployments
List Deployments in a resource group
```ruby
- azure_resources_service.deployments(resource_group: '<Resource Group Name>').each do |deployment|
+fog_resources_service.deployments(resource_group: '<Resource Group Name>').each do |deployment|
puts "#{deployment.name}"
- end
+end
```
## Retrieve a single Deployment
Get a single record of Deployment
```ruby
- deployment = azure_resources_service
- .deployments
- .get('<Resource Group name>', '<Deployment name>')
- puts "#{deployment.name}"
+deployment = fog_resources_service
+ .deployments
+ .get('<Resource Group Name>', '<Deployment Name>')
+puts "#{deployment.name}"
```
## Destroy a single Deployment
Get Deployment object from the get method(described above) and then destroy that Deployment.
```ruby
- deployment.destroy
+deployment.destroy
```
## Support and Feedback
Your feedback is appreciated! If you have specific issues with the fog ARM, you should file an issue via Github.