Skip to content

EventHub: updated for GEO DR #1709

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fearthecowboy merged 9 commits into from
Sep 26, 2017
Merged

EventHub: updated for GEO DR #1709

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
75dfbf9
Removed maxLength from entity name
Aug 10, 2017
9d0cde4
Geo DR changes
Aug 16, 2017
22bc6a7
review changes
Sep 20, 2017
d1f92d7
alias connection string added.
Sep 20, 2017
f50fc80
Merge branch 'current' of https://github.com/Azure/azure-rest-api-spe…
Sep 20, 2017
9caa0be
description updated
Sep 20, 2017
1c1ac61
Review comments and examples
Sep 22, 2017
3ac37b5
pluralize opertionsIds and reveted delete response code to 200
Sep 23, 2017
d42d401
Removed LastSync Property
Sep 25, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
343 changes: 343 additions & 0 deletions specification/eventhub/resource-manager/Microsoft.EventHub/2017-04-01/EventHub.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -664,6 +664,263 @@
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/disasterRecoveryConfigs": {
"get": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_List",
"x-ms-examples": {
"EHAliasList": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasList.json" }
},
"description": "Gets all Alias(Disaster Recovery configurations)",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Successfully retrieved the list of Alias(Disaster Recovery configurations) for eventhub namespace",
"schema": {
"$ref": "#/definitions/ArmDisasterRecoveryListResult"
}
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
},
"x-ms-pageable": {
"nextLinkName": "nextLink"
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/disasterRecoveryConfigs/{alias}": {
"put": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_CreateOrUpdate",
"x-ms-examples": {
"EHAliasCreate": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasCreate.json" }
},
"description": "Creates or updates a new Alias(Disaster Recovery configuration)",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/aliasNameParameter"
},
{
"name": "parameters",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/ArmDisasterRecovery"
},
"description": "Parameters required to create an Alias(Disaster Recovery configuration)"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Alias(Disaster Recovery configuration) successfully created",
"schema": {
"$ref": "#/definitions/ArmDisasterRecovery"
}
},
"201": {
"description": "Alias(Disaster Recovery configuration) creation request received"
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
}
},
"delete": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_Delete",
"x-ms-examples": {
"EHAliasDelete": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasDelete.json" }
},
"description": "Deletes an Alias(Disaster Recovery configuration)",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/aliasNameParameter"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Delete Alias(Disaster Recovery configuration) request accepted"
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
}
},
"get": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_Get",
"x-ms-examples": {
"EHAliasGet": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasGet.json" }
},
"description": "Retrieves Alias(Disaster Recovery configuration) for primary or secondary namespace",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/aliasNameParameter"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Successfully retrieved the Alias(Disaster Recovery configurations)",
"schema": {
"$ref": "#/definitions/ArmDisasterRecovery"
}
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/disasterRecoveryConfigs/{alias}/breakPairing": {
"post": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_BreakPairing",
"x-ms-examples": {
"EHAliasBreakPairing": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasBreakPairing.json" }
},
"description": "This operation disables the Disaster Recovery and stops replicating changes from primary to secondary namespaces",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/aliasNameParameter"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Break-Pairing operation is successful."
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/disasterRecoveryConfigs/{alias}/failover": {
"post": {
"tags": [
"DisasterRecoveryConfigs"
],
"operationId": "DisasterRecoveryConfigs_FailOver",
"x-ms-examples": {
"EHAliasFailOver": { "$ref": "./examples/disasterRecoveryConfigs/EHAliasFailOver.json" }
},
"description": "envokes GEO DR failover and reconfigure the alias to point to the secondary namespace",
"parameters": [
{
"$ref": "#/parameters/resourceGroupNameParameter"
},
{
"$ref": "#/parameters/namespaceNameParameter"
},
{
"$ref": "#/parameters/aliasNameParameter"
},
{
"$ref": "#/parameters/ApiVersionParameter"
},
{
"$ref": "#/parameters/SubscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "Failover operation is successful."
},
"default": {
"description": "Eventhub error response describing why the operation failed.",
"schema": {
"$ref": "#/definitions/ErrorResponse"
}
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs": {
"get": {
"tags": [
Expand Down Expand Up @@ -1550,6 +1807,16 @@
"type": "string",
"description": "Secondary connection string of the created namespace AuthorizationRule."
},
"aliasPrimaryConnectionString": {
"readOnly": true,
"type": "string",
"description": "Primary connection string of the alias if GEO DR is enabled"
},
"aliasSecondaryConnectionString": {
"readOnly": true,
"type": "string",
"description": "Secondary connection string of the alias if GEO DR is enabled"
},
"primaryKey": {
"readOnly": true,
"type": "string",
Expand Down Expand Up @@ -1904,6 +2171,71 @@
"type": "string"
}
}
},
"ArmDisasterRecovery": {
"properties": {
"properties": {
"x-ms-client-flatten": true,
"properties": {
"provisioningState": {
Copy link
Copy Markdown
Contributor

@ravbhatnagar ravbhatnagar Sep 21, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

enum. What about a Failed provisioning State value? You mention that possible values as accepted or succeeded. In case the operation fails, failed should be returned. And do you support cancel? In that case, you will have a canceled provisioning state as well.

Copy link
Copy Markdown
Contributor Author

@v-Ajnava v-Ajnava Sep 22, 2017

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resolved, we don't support cancel.

"readOnly": true,
"type": "string",
"description": "Provisioning state of the Alias(Disaster Recovery configuration) - possible values 'Accepted' or 'Succeeded' or 'Failed'",
"enum": [
"Accepted",
"Succeeded",
"Failed"
],
"x-ms-enum": {
"name": "ProvisioningStateDR",
"modelAsString": false
}
},
"partnerNamespace": {
"type": "string",
"description": "Primary/Secondary eventhub namespace name, which is part of GEO DR pairning"
},
"role": {
"readOnly": true,
"type": "string",
"description": "role of namespace in GEO DR - possible values 'Primary' or 'PrimaryNotReplicating' or 'Secondary'",
"enum": [
"Primary",
"PrimaryNotReplicating",
"Secondary"
],
"x-ms-enum": {
"name": "RoleDisasterRecovery",
"modelAsString": false
}
}
},
"description": "Properties required to the Create Or Update Alias(Disaster Recovery configurations)"
}
},
"allOf": [
{
"$ref": "#/definitions/Resource"
}
],
"description": "Single item in List or Get Alias(Disaster Recovery configuration) operation"
},
"ArmDisasterRecoveryListResult": {
"properties": {
"value": {
"type": "array",
"items": {
"$ref": "#/definitions/ArmDisasterRecovery"
},
"description": "List of Alias(Disaster Recovery configurations)"
},
"nextLink": {
"type": "string",
"readOnly": true,
"description": "Link to the next set of results. Not empty if Value contains incomplete list of Alias(Disaster Recovery configuration)"
}
},
"description": "The result of the List Alias(Disaster Recovery configuration) operation."
}
},
"parameters": {
Expand Down Expand Up @@ -1959,12 +2291,23 @@
"x-ms-parameter-location": "method",
"description": "The Event Hub name"
},
"aliasNameParameter": {
"name": "alias",
"in": "path",
"required": true,
"type": "string",
"minLength": 1,
"maxLength": 50,
"x-ms-parameter-location": "method",
"description": "The Disaster Recovery configuration name"
},
"consumerGroupNameParameter": {
"name": "consumerGroupName",
"in": "path",
"required": true,
"type": "string",
"minLength": 1,
"maxLength": 50,
"x-ms-parameter-location": "method",
"description": "The consumer group name"
}
Expand Down
12 changes: 12 additions & 0 deletions ...r/Microsoft.EventHub/2017-04-01/examples/disasterRecoveryConfigs/EHAliasBreakPairing.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"parameters": {
"namespaceName": "sdk-Namespace-8859",
"resourceGroupName": "ardsouzatestRG",
"alias": "sdk-DisasterRecovery-3814",
"api-version": "2017-04-01",
"subscriptionId": "5f750a97-50d9-4e36-8081-c9ee4c0210d4"
},
"responses": {
"200": {}
}
}
Loading