TagREST Resource

PUT /tags/importservicetags

Request Body
media type data type
application/json ServiceTags (JSON)

Example

Request
PUT /tags/importservicetags
Content-Type: application/json

                
{
  "resourceToTagIds" : {
    "property1" : [ 12345, 12345 ],
    "property2" : [ 12345, 12345 ]
  },
  "cachedTags" : {
    "property1" : 12345,
    "property2" : 12345
  },
  "tagUpdateTime" : 12345,
  "serviceName" : "...",
  "serviceResources" : [ {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  }, {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  } ],
  "tagVersion" : 12345,
  "tagsChangeExtent" : "TAGS",
  "tags" : {
    "property1" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "tagDefinitions" : {
    "property1" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "isDelta" : true,
  "op" : "..."
}
Response
HTTP/1.1 204 No Content

GET /tags/resources

Response Body
media type data type description
application/json array of RangerServiceResource (JSON)

Example

Request
GET /tags/resources
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

POST /tags/resources

Request Parameters
name type description default constraints
updateIfExists query true boolean
Request Body
media type data type
application/json RangerServiceResource (JSON)
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
POST /tags/resources
Content-Type: application/json
Accept: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/tagdefs

Response Body
media type data type description
application/json array of RangerTagDef (JSON)

Example

Request
GET /tags/tagdefs
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

POST /tags/tagdefs

Request Parameters
name type description default constraints
updateIfExists query true boolean
Request Body
media type data type
application/json RangerTagDef (JSON)
Response Body
media type data type description
application/json RangerTagDef (JSON)

Example

Request
POST /tags/tagdefs
Content-Type: application/json
Accept: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/tagresourcemaps

Request Parameters
name type description
resource-guid query
tag-guid query

Example

Request
DELETE /tags/tagresourcemaps
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tagresourcemaps

Response Body
media type data type description
application/json array of RangerTagResourceMap (JSON)

Example

Request
GET /tags/tagresourcemaps
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "tagId" : 12345,
  "resourceId" : 12345,
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

POST /tags/tagresourcemaps

Request Parameters
name type description default constraints
lenient query false boolean
resource-guid query    
tag-guid query    
Response Body
media type data type description
application/json RangerTagResourceMap (JSON)

Example

Request
POST /tags/tagresourcemaps
Content-Type: application/json
Accept: application/json

                
...
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "tagId" : 12345,
  "resourceId" : 12345,
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/tags

Response Body
media type data type description
application/json array of RangerTag (JSON)

Example

Request
GET /tags/tags
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

POST /tags/tags

Request Parameters
name type description default constraints
updateIfExists query true boolean
Request Body
media type data type
application/json RangerTag (JSON)
Response Body
media type data type description
application/json RangerTag (JSON)

Example

Request
POST /tags/tags
Content-Type: application/json
Accept: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/types

Response Body
media type data type description
application/json array of string (JSON)

Example

Request
GET /tags/types
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

GET /tags/download/{serviceName}

Request Parameters
name type description default constraints
serviceName path    
lastActivationTime query 0 long
lastKnownVersion query   long
pluginCapabilities query  
pluginId query    
supportsTagDeltas query false boolean
Response Body
media type data type description
application/json ServiceTags (JSON)

Example

Request
GET /tags/download/{serviceName}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "resourceToTagIds" : {
    "property1" : [ 12345, 12345 ],
    "property2" : [ 12345, 12345 ]
  },
  "cachedTags" : {
    "property1" : 12345,
    "property2" : 12345
  },
  "tagUpdateTime" : 12345,
  "serviceName" : "...",
  "serviceResources" : [ {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  }, {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  } ],
  "tagVersion" : 12345,
  "tagsChangeExtent" : "ALL",
  "tags" : {
    "property1" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "tagDefinitions" : {
    "property1" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "isDelta" : true,
  "op" : "..."
}

DELETE /tags/resource/{id}

Request Parameters
name type description constraints
id path long

Example

Request
DELETE /tags/resource/{id}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/resource/{id}

Request Parameters
name type description constraints
id path long
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
GET /tags/resource/{id}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

PUT /tags/resource/{id}

Request Parameters
name type description constraints
id path long
Request Body
media type data type
application/json RangerServiceResource (JSON)
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
PUT /tags/resource/{id}
Content-Type: application/json
Accept: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/server/tagdeltas

Request Parameters
name type description default constraints
days query 3 int

Example

Request
DELETE /tags/server/tagdeltas
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

DELETE /tags/tag/{id}

Request Parameters
name type description constraints
id path long

Example

Request
DELETE /tags/tag/{id}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tag/{id}

Request Parameters
name type description constraints
id path long
Response Body
media type data type description
application/json RangerTag (JSON)

Example

Request
GET /tags/tag/{id}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

PUT /tags/tag/{id}

Request Parameters
name type description constraints
id path long
Request Body
media type data type
application/json RangerTag (JSON)
Response Body
media type data type description
application/json RangerTag (JSON)

Example

Request
PUT /tags/tag/{id}
Content-Type: application/json
Accept: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/tagdef/{id}

Request Parameters
name type description constraints
id path long

Example

Request
DELETE /tags/tagdef/{id}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tagdef/{id}

Request Parameters
name type description constraints
id path long
Response Body
media type data type description
application/json RangerTagDef (JSON)

Example

Request
GET /tags/tagdef/{id}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

PUT /tags/tagdef/{id}

Request Parameters
name type description constraints
id path long
Request Body
media type data type
application/json RangerTagDef (JSON)
Response Body
media type data type description
application/json RangerTagDef (JSON)

Example

Request
PUT /tags/tagdef/{id}
Content-Type: application/json
Accept: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/tagresourcemap/tag-resource-guid

Request Parameters
name type description
resourceGuid query
tagGuid query
Response Body
media type data type description
application/json RangerTagResourceMap (JSON)

Example

Request
GET /tags/tagresourcemap/tag-resource-guid
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "tagId" : 12345,
  "resourceId" : 12345,
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/tagresourcemap/{id}

Request Parameters
name type description constraints
id path long

Example

Request
DELETE /tags/tagresourcemap/{id}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tagresourcemap/{id}

Request Parameters
name type description constraints
id path long
Response Body
media type data type description
application/json RangerTagResourceMap (JSON)

Example

Request
GET /tags/tagresourcemap/{id}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "tagId" : 12345,
  "resourceId" : 12345,
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/resource/guid/{guid}

Request Parameters
name type description default constraints
guid path    
deleteReferences query false boolean

Example

Request
DELETE /tags/resource/guid/{guid}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/resource/guid/{guid}

Request Parameters
name type description
guid path
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
GET /tags/resource/guid/{guid}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

PUT /tags/resource/guid/{guid}

Request Parameters
name type description
guid path
Request Body
media type data type
application/json RangerServiceResource (JSON)
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
PUT /tags/resource/guid/{guid}
Content-Type: application/json
Accept: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/resources/service/{serviceName}

Request Parameters
name type description
serviceName path
Response Body
media type data type description
application/json array of RangerServiceResource (JSON)

Example

Request
GET /tags/resources/service/{serviceName}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

GET /tags/secure/download/{serviceName}

Request Parameters
name type description default constraints
serviceName path    
lastActivationTime query 0 long
lastKnownVersion query   long
pluginCapabilities query  
pluginId query    
supportsTagDeltas query false boolean
Response Body
media type data type description
application/json ServiceTags (JSON)

Example

Request
GET /tags/secure/download/{serviceName}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "resourceToTagIds" : {
    "property1" : [ 12345, 12345 ],
    "property2" : [ 12345, 12345 ]
  },
  "cachedTags" : {
    "property1" : 12345,
    "property2" : 12345
  },
  "tagUpdateTime" : 12345,
  "serviceName" : "...",
  "serviceResources" : [ {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  }, {
    "resourceSignature" : "...",
    "resourceElements" : {
      "property1" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      },
      "property2" : {
        "isExcludes" : true,
        "values" : [ "...", "..." ],
        "isRecursive" : true
      }
    },
    "serviceName" : "...",
    "ownerUser" : "...",
    "additionalInfo" : {
      "property1" : "...",
      "property2" : "..."
    },
    "guid" : "...",
    "isEnabled" : true,
    "createTime" : 12345,
    "createdBy" : "...",
    "updatedBy" : "...",
    "id" : 12345,
    "updateTime" : 12345,
    "version" : 12345
  } ],
  "tagVersion" : 12345,
  "tagsChangeExtent" : "ALL",
  "tags" : {
    "property1" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "owner" : 12345,
      "validityPeriods" : [ {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      }, {
        "startTime" : "...",
        "endTime" : "...",
        "timeZone" : "...",
        "recurrences" : [ { }, { } ]
      } ],
      "type" : "...",
      "attributes" : {
        "property1" : "...",
        "property2" : "..."
      },
      "options" : {
        "property1" : { },
        "property2" : { }
      },
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "tagDefinitions" : {
    "property1" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    },
    "property2" : {
      "attributeDefs" : [ {
        "type" : "...",
        "name" : "..."
      }, {
        "type" : "...",
        "name" : "..."
      } ],
      "name" : "...",
      "source" : "...",
      "guid" : "...",
      "isEnabled" : true,
      "createTime" : 12345,
      "createdBy" : "...",
      "updatedBy" : "...",
      "id" : 12345,
      "updateTime" : 12345,
      "version" : 12345
    }
  },
  "isDelta" : true,
  "op" : "..."
}

DELETE /tags/tag/guid/{guid}

Request Parameters
name type description
guid path

Example

Request
DELETE /tags/tag/guid/{guid}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tag/guid/{guid}

Request Parameters
name type description
guid path
Response Body
media type data type description
application/json RangerTag (JSON)

Example

Request
GET /tags/tag/guid/{guid}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

PUT /tags/tag/guid/{guid}

Request Parameters
name type description
guid path
Request Body
media type data type
application/json RangerTag (JSON)
Response Body
media type data type description
application/json RangerTag (JSON)

Example

Request
PUT /tags/tag/guid/{guid}
Content-Type: application/json
Accept: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/tagdef/guid/{guid}

Request Parameters
name type description
guid path

Example

Request
DELETE /tags/tagdef/guid/{guid}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tagdef/guid/{guid}

Request Parameters
name type description
guid path
Response Body
media type data type description
application/json RangerTagDef (JSON)

Example

Request
GET /tags/tagdef/guid/{guid}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/tagdef/name/{name}

Request Parameters
name type description
name path
Response Body
media type data type description
application/json RangerTagDef (JSON)

Example

Request
GET /tags/tagdef/name/{name}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "attributeDefs" : [ {
    "type" : "...",
    "name" : "..."
  }, {
    "type" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "source" : "...",
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

DELETE /tags/tagresourcemap/guid/{guid}

Request Parameters
name type description
guid path

Example

Request
DELETE /tags/tagresourcemap/guid/{guid}
Content-Type: */*

                
...
Response
HTTP/1.1 204 No Content

GET /tags/tagresourcemap/guid/{guid}

Request Parameters
name type description
guid path
Response Body
media type data type description
application/json RangerTagResourceMap (JSON)

Example

Request
GET /tags/tagresourcemap/guid/{guid}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "tagId" : 12345,
  "resourceId" : 12345,
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}

GET /tags/tags/cache/reset

Resets/ removes tag policy cache for given service.

Request Parameters
name type description
serviceName query non-empty service-name
Response Body
media type data type description
application/json boolean (JSON) true if successfully reseted/ removed for given service, false otherwise.

Example

Request
GET /tags/tags/cache/reset
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

GET /tags/tags/cache/reset-all

Resets/ removes tag policy cache for all.

Response Body
media type data type description
application/json boolean (JSON) true if successfully reseted/ removed, false otherwise.

Example

Request
GET /tags/tags/cache/reset-all
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
...

GET /tags/tags/type/{type}

Request Parameters
name type description
type path
Response Body
media type data type description
application/json array of RangerTag (JSON)

Example

Request
GET /tags/tags/type/{type}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "owner" : 12345,
  "validityPeriods" : [ {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  }, {
    "startTime" : "...",
    "endTime" : "...",
    "timeZone" : "...",
    "recurrences" : [ {
      "interval" : { },
      "schedule" : { }
    }, {
      "interval" : { },
      "schedule" : { }
    } ]
  } ],
  "type" : "...",
  "attributes" : {
    "property1" : "...",
    "property2" : "..."
  },
  "options" : {
    "property1" : { },
    "property2" : { }
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
} ]

GET /tags/resource/service/{serviceName}/signature/{resourceSignature}

Request Parameters
name type description
resourceSignature path
serviceName path
Response Body
media type data type description
application/json RangerServiceResource (JSON)

Example

Request
GET /tags/resource/service/{serviceName}/signature/{resourceSignature}
Content-Type: */*
Accept: application/json

                
...
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "resourceSignature" : "...",
  "resourceElements" : {
    "property1" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    },
    "property2" : {
      "isExcludes" : true,
      "values" : [ "...", "..." ],
      "isRecursive" : true
    }
  },
  "serviceName" : "...",
  "ownerUser" : "...",
  "additionalInfo" : {
    "property1" : "...",
    "property2" : "..."
  },
  "guid" : "...",
  "isEnabled" : true,
  "createTime" : 12345,
  "createdBy" : "...",
  "updatedBy" : "...",
  "id" : 12345,
  "updateTime" : 12345,
  "version" : 12345
}